tamipes/authentik-nix
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge pull request #95 from freiheitsrechte/add-docs-migrating

Browse source 
README: Add considerations for migrating a deployment
This commit is contained in:
Maximilian Bosch 2026-02-28 20:54:41 +01:00 • committed by GitHub
commit 5818986331
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 11 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

11
README.md
View file

@ -179,6 +179,17 @@ The build artifacts from successful CI runs should be available from the corresp
https://app.cachix.org/cache/nix-community https://app.cachix.org/cache/nix-community
## Migrating
When migrating an `authentik-nix` deployment from one machine to another the following considerations may be helpful.
- Copy `/var/lib/authentik` to the new machine, and be aware that it is a symlink. `/media` is most important.
- Lock the revision that's used to build `authentik-nix` to not down- or upgrade by accident, making debugging harder if needed.
- Dump database according to [upstream's documentation](https://docs.goauthentik.io/sys-mgmt/ops/backup-restore/).
- By default, certs are written to the database, not filesystem. Migrating certs by restoring the database works.
- authentik runs fine with a different domain or base URL, you may test everything and only then adjust DNS records for production deployment.
## License ## License
This project is released under the terms of the MIT License. See [LICENSE](./LICENSE). This project is released under the terms of the MIT License. See [LICENSE](./LICENSE).
Consult [the upstream project](https://github.com/goauthentik/authentik) for information about authentik licensing. Consult [the upstream project](https://github.com/goauthentik/authentik) for information about authentik licensing.