nixos-mailserver/docs/migrations.rst
Martin Weinelt 4225cc759f
Introduce stateVersion concept
With upcoming changes to the dovecot home and maildirectories we need to
introduce a way to nudge users to inform themselves about manual
migration steps they might need to carry out.
2025-05-22 05:49:22 +02:00

23 lines
630 B
ReStructuredText

Migrations
==========
With mailserver configuration best practices changing over time migrations are
a required step to complete before updating to a new version of NixOS
mailserver.
The initial `mailserver.stateVersion` value should be copied from the setup
guide that you used to initially set up your mailserver. If in doubt you can
always initialize it at `1` and walk through all assertions, that might apply
to your setup.
NixOS 25.11
-----------
This option was introduced in the NixOS 25.11 release cycle, in which case you
can safely initialize its value at `1`.
:: code-block: nix
mailserver.stateVersion = 1;