doc/dns_config.md

DNS zone configuration

Sample DNS zone configuration for domain.tld domain nane:

Redirection from the domain name to the IP address

@ 1800 IN A 111.222.333.444 # (Minimal) IPv4
@ 1800 IN AAAA 2001:AABB:CCDD:EEFF:1122:3344:5566:7788 # IPv6

* 1800 IN A 111.222.333.444 # Wildcard
* 1800 IN AAAA 2001:AABB:CCDD:EEFF:1122:3344:5566:7788

Subdomains

www 1800 IN CNAME @ # accesible at www.domain.tld

XMPP

_xmpp-client._tcp 1800 IN SRV 0 5 5222 domain.tld. # (Minimal) clients connection
_xmpp-server._tcp 1800 IN SRV 0 5 5269 domain.tld. # (Minimal) servers connection

muc 1800 IN CNAME @ # multi-user chat rooms at muc.domain.tld
anonymous 1800 IN CNAME @ # connection without account at `anonymous.domain.tld`
bosh 1800 CNAME @ # BOSH
_xmppconnect 1800 TXT "_xmpp-client-xbosh=https://bosh.domain.tld:5281/http-bind"
pubsub 1800 IN CNAME @
vjud 1800 IN CNAME @

Email

@ 1800 IN MX 10 domain.tld. # (Minimal)
@ 1800 IN TXT "v=spf1 a mx -all"

Set up

Replace:

• "domain.tld" with your own domain preserving the dot at the end.
• IP samples values with your server IP addresses:

• 111.222.333.444: IPv4.
• 2001:AABB:CCDD:EEFF:1122:3344:5566:7788: IPv6.

DNS lines for subdomains, XMPP and email does not works without a redirection from the domain name to the IP address (one line is enough) because they depends on it.

To begin: lines with "(Minimal)" are the minimal required DNS entries to make works redirection from the domain name to the IP adress, XMPP and email.

Warning: @ is the default domain name currently defined, some registrar (like OVH) does not accept it, so replace @ by your domain name (domain.tld**.**) with a dot at the end.

Time to live

All DNS lines above have 1800 value (30 minutes). It corresponds to Time to live (TTL) which represents and indicate time, in seconds, during which the DNS line can be kept in the cache. After this time, the information must me considered obsolete and must be update.