randogoth/nanuqsaurus
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: nixos-26.05 in adopt examples, document impermanence

Browse source 
Bump the wrapper-flake nixpkgs channel in the adopt/laptop examples to
nixos-26.05, and add the "Impermanence (optional)" section covering the
/persist subvolume, the required "nixos" fs label, and the default
persistence set.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
randogoth 2026-08-28 12:38:06 +03:00
parent 17cce973fc
commit d1321cf7ca
2 changed files with 236 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

29
docs/adopt.md
View file

@ -22,7 +22,7 @@ On the target machine:
description = "Local wrapper for the nanuqsaurus profile";
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-25.11";
nixpkgs.url = "github:NixOS/nixpkgs/nixos-26.05";
nanuqsaurus = {
url = "git+https://codeberg.org/randogoth/nanuqsaurus.git";
inputs.nixpkgs.follows = "nixpkgs";
@ -53,6 +53,8 @@ On the target machine:
{
# Optional: change the default admin username ("admin")
nanuqsaurus.admin.username = "admin";
# Optional: enable impermanence (requires a /persist Btrfs subvolume and mounts in hardware-configuration.nix)
# nanuqsaurus.impermanence.enable = true;
networking.hostName = "nanuqsaurus";
system.stateVersion = "25.11";
}
@ -75,3 +77,28 @@ sudo nixos-rebuild switch --flake /etc/nixos#nanuqsaurus
- `sudo nixos-rebuild switch --flake /etc/nixos#nanuqsaurus`
- Keep all your machine-specific changes in the wrapper flake (additional modules, packages, services, etc.).
## Impermanence (optional)
If you enable `nanuqsaurus.impermanence.enable = true;` you must:
- Add a `/persist` mount (Btrfs subvolume) in `hardware-configuration.nix`.
- Migrate state you care about into `/persist` before the first reboot.
Notes:
- The rollback logic expects the root Btrfs volume label to be `nixos`.
- Create the subvolume with `btrfs subvolume create /mnt/persist` and mount it as `/persist`.
The default persistence set includes:
- `/etc/nixos`
- `/etc/ssh`
- `/etc/cups`
- `/var/lib/cups`
- `/var/lib/libvirt`
- `/var/lib/secureboot`
- `/var/lib/tailscale`
- `/var/lib/systemd`
- `/var/lib/nixos`
- `/etc/machine-id`