Skip to content

Latest commit

 

History

History
51 lines (30 loc) · 2.9 KB

configuring-dns.md

File metadata and controls

51 lines (30 loc) · 2.9 KB

Configuring DNS settings

Prerequisites > Configuring DNS settings > Getting the playbook > Configuring the playbook > Installing

To reach your services, you'd need to do some DNS configuration.

We recommend that you:

  • create at least one generic domain (e.g. mash.example.com) for easily hosting various services at different subpaths (e.g. mash.example.com/miniflux, mash.example.com/radicale, etc.)

  • create additional domains (CNAME DNS records pointing to the main generic domain) for large services or services that explicitly require their own dedicated domain

Some services (like Uptime-kuma) require being hosted at their own dedicated domain. Others, you can put on their own domain/subdomain or at subpaths on any domain you'd like.

Example DNS settings

As an example setup, adjust DNS records as below.

Service Type Host Priority Weight Port Target
Miniflux, Radicale, others A mash - - - mash-server-IP
Nextcloud CNAME cloud - - - mash.example.com

With such a setup, you could reach:

  • the feedreader Miniflux at https://mash.example.com/miniflux (if you set miniflux_hostname: mash.example.com and miniflux_path_prefix: /miniflux in your vars.yml)

  • the Radicale CalDAV/CardDAV sever at https://mash.example.com/radicale (if you set radicale_hostname: mash.example.com and radicale_path_prefix: /radicale in your vars.yml)

  • Nextcloud at its own dedicated domain, at https://cloud.example.com

Hosting services at subpaths is more convenient, because it doesn't require you to create additional DNS records and no new SSL certificates need to be retrieved.

Still, if you'd like each service to have its own dedicated domain (or subdomain), feel free to configure services that way by making sure that you set <service>_hostname and <service>_path_prefix accordingly in your vars.yml.

Be mindful as to how long it will take for the DNS records to propagate.

Note: if you are using Cloudflare DNS, make sure to disable the proxy and set all records to "DNS only". Otherwise, fetching certificates will fail.

▶️ When you're done with the DNS configuration and ready to proceed, continue with Getting the playbook.