6ff4a50f02
After bumping the generation of new DKIM keys to RSA 2048 in NixOS 25.11 key rotation for existing users could not be done safely. To resolve this situation we now support multiple generations of selectors per domain to enable proper DKIM key transitions as described in RFC6376 3.1. The added documentation introduces and motivates DKIM and guides the user through a DKIM key rotation. Additionally, DKIM key material can now also be treated as a managed secrets when autogenerated state on the mail server host is undesirable. This change is fully backwards compatible in behavior and will continue to use the previously generated DKIM key without any additional configuration up until the point when DKIM selectors are configured explicitly.
55 lines
878 B
ReStructuredText
55 lines
878 B
ReStructuredText
.. NixOS Mailserver documentation master file, created by
|
|
sphinx-quickstart on Thu Jul 2 20:50:36 2020.
|
|
You can adapt this file completely to your liking, but it should at least
|
|
contain the root `toctree` directive.
|
|
|
|
Welcome to NixOS Mailserver's documentation!
|
|
============================================
|
|
|
|
.. image:: logo.png
|
|
:width: 400
|
|
:alt: SNM Logo
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
setup-guide
|
|
advanced-configurations
|
|
howto-develop
|
|
faq
|
|
release-notes
|
|
options
|
|
migrations
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
:caption: Features
|
|
|
|
dkim
|
|
fts
|
|
ldap
|
|
srs
|
|
|
|
.. toctree::
|
|
:maxdepth: 0
|
|
:caption: How-to
|
|
|
|
autodiscovery
|
|
backup-guide
|
|
flakes
|
|
rspamd-tuning
|
|
|
|
.. toctree::
|
|
:maxdepth: 0
|
|
:caption: Integrations
|
|
|
|
radicale
|
|
roundcube
|
|
|
|
Indices and tables
|
|
==================
|
|
|
|
* :ref:`genindex`
|
|
* :ref:`modindex`
|
|
* :ref:`search`
|