diff --git a/docs/dns.rst b/docs/dns.rst index d2fd4131..027ce4fc 100644 --- a/docs/dns.rst +++ b/docs/dns.rst @@ -48,3 +48,13 @@ And for another domain, ``myotherdomain.com`` for example: myotherdomain.com. IN MX 10 mail.mydomain.com. Note that both point to the same mail server hostname, which is unique to your server. + +DKIM/SPF & DMARC Entries +------------------------ + +Finally, you'll need to visit the admin dashboard (or use the cli) to regenerate your DMARC, SPF, and DKIM records. + +Once the DNS changes to your host have propogated (and if SSL / domain rules were setup correctly), visit your admin +dashboard at https://example.com/admin/ui/domain/details/example.com. Click on `regenerate keys` and add the required +records to your DNS provider. If you've enabled DKIM/SPF / DMARC and haven't added these entries, your mail might +not get delivered. diff --git a/docs/faq.rst b/docs/faq.rst index 8d6b283f..7b82a3cd 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -312,6 +312,11 @@ down and up again. A container restart is not sufficient. *Issue reference:* `615`_. +Access Denied Errors +-------------------- + +While this may be due to several issues, check to make sure your ``DOMAIN=`` entry is the **first** entry in your ``HOSTNAMES=``. + TLS certificate issues `````````````````````` diff --git a/docs/setup.rst b/docs/setup.rst index eb79a697..df387c51 100644 --- a/docs/setup.rst +++ b/docs/setup.rst @@ -61,6 +61,10 @@ Perform the specific setup steps Specific setup steps are described per flavor (Compose, Kubernetes, etc.) and you should follow the steps after completing the requirements. +After setting up your flavor, continue to the DNS setup instructions, +additional steps in the admin dashboard will be needed to generate your +DMARC and SPF/DKIM keys. + Make sure that you test properly before going live! - Try to send an email to an external service diff --git a/setup/templates/steps/compose/03_expose.html b/setup/templates/steps/compose/03_expose.html index c909fc9b..291ea672 100644 --- a/setup/templates/steps/compose/03_expose.html +++ b/setup/templates/steps/compose/03_expose.html @@ -50,7 +50,9 @@ avoid generic all-interfaces addresses like 0.0.0.0 or ::You server will be available under a main hostname but may expose multiple public hostnames. Every e-mail domain that points to this server must have one of the -hostnames in its MX record. Hostnames must be coma-separated.

+hostnames in its MX record. Hostnames must be coma-separated. If you're having +trouble accessing your admin interface, make sure it is the first entry here (and possibly the +same as your DOMAIN entry from earlier.

diff --git a/setup/templates/steps/stack/03_expose.html b/setup/templates/steps/stack/03_expose.html index 5377d3bd..c5daa24d 100644 --- a/setup/templates/steps/stack/03_expose.html +++ b/setup/templates/steps/stack/03_expose.html @@ -11,7 +11,9 @@ you expose it to the world.

You server will be available under a main hostname but may expose multiple public hostnames. Every e-mail domain that points to this server must have one of the -hostnames in its MX record. Hostnames must be coma-separated.

+hostnames in its MX record. Hostnames must be coma-separated. If you're having +trouble accessing your admin interface, make sure it is the first entry here (and possibly the +same as your DOMAIN entry from earlier.