doc/dns_config.md

47 lines
1.7 KiB
Markdown
Raw Normal View History

2016-02-15 18:54:04 +01:00
## DNS zone configuration
2014-06-17 22:11:38 +02:00
2016-02-15 18:54:04 +01:00
Sample DNS zone configuration for `domain.tld` domain nane:
2014-06-17 22:11:38 +02:00
2016-02-15 18:54:04 +01:00
#### Redirection from the domain name to the IP address
2014-06-17 22:14:35 +02:00
```bash
2016-02-15 18:54:04 +01:00
@ 900 IN A 111.222.333.444 # (Minimal) IPv4
@ 900 IN AAAA 2001:AABB:CCDD:EEFF:1122:3344:5566:7788 # IPv6
* 900 IN A 111.222.333.444 # Wildcard
2015-09-08 12:20:08 +02:00
* 900 IN AAAA 2001:AABB:CCDD:EEFF:1122:3344:5566:7788
2016-02-15 18:54:04 +01:00
```
2014-06-17 22:22:15 +02:00
2016-02-15 18:54:04 +01:00
#### Subdomains
```bash
www 1800 IN CNAME @ # accesible at www.domain.tld
```
2014-06-17 22:22:15 +02:00
2016-02-15 18:54:04 +01:00
#### XMPP
```bash
_xmpp-client._tcp 14400 IN SRV 0 5 5222 domain.tld. # (Minimal) clients connection
_xmpp-server._tcp 14400 IN SRV 0 5 5269 domain.tld. # (Minimal) servers connection
muc 1800 IN CNAME @ # multi-user chat rooms at muc.domain.tld
2016-02-16 11:47:35 +01:00
anonymous 1800 IN CNAME @ # connection without account at `anonymous.domain.tld`
2016-02-16 11:53:34 +01:00
bosh 1800 CNAME @ # BOSH
_xmppconnect 1800 TXT "_xmpp-client-xbosh=https://bosh.domain.tld:5281/http-bind"
2014-06-17 22:11:38 +02:00
pubsub 1800 IN CNAME @
vjud 1800 IN CNAME @
2016-02-15 18:54:04 +01:00
```
2014-06-17 22:22:15 +02:00
2016-02-15 18:54:04 +01:00
#### Email
```bash
2014-11-28 20:29:08 +01:00
@ 900 IN MX 10 domain.tld. (Minimal)
2014-06-17 22:57:49 +02:00
@ 900 IN TXT "v=spf1 a mx -all"
2014-06-17 22:22:15 +02:00
```
2014-06-17 22:29:24 +02:00
2016-02-15 18:54:04 +01:00
#### 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](http://ip.yunohost.org/).
* `2001:AABB:CCDD:EEFF:1122:3344:5566:7788`: [IPv6](http://ip6.yunohost.org/).
2016-02-15 18:54:04 +01:00
<div class="alert alert-info"><b>To begin:</b> lines with "(Minimal)" are the minimal required DNS entries to make works redirection from the domain name to the IP adress, XMPP and email.</div>
2014-11-28 20:29:08 +01:00
2015-09-30 23:18:39 +02:00
<div class="alert alert-warning"><b>Warning:</b> <b>@</b> 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.</div>