bernardo/Nomarchy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add TROUBLESHOOTING.md for the five common rebuild errors

Browse Source 
Covers: option-already-declared (duplicate mkOption), attribute-missing
(forgot to import nomarchy.nixosModules.system), Stylix target conflict
(needs lib.mkForce, not bare bool), home-manager .hm-bak churn (left over
from backupFileExtension after first install), and impermanence path
missing (dir not in environment.persistence list).

Each entry has the literal error text, the cause, and a copy-paste fix.
Linked from README.md and docs/MIGRATION.md so users hit it before
guessing.
This commit is contained in:
Bernardo Magri
2026-04-26 09:16:40 +01:00
parent 21ee9c6035
commit 4b2f16c2f0
4 changed files with 126 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
docs/MIGRATION.md
View File

@@ -216,6 +216,9 @@ Impermanence is **off** unless you set `nomarchy.system.impermanence.enable = tr
and it requires a BTRFS layout with a `root-blank` snapshot. Don't enable it
on an existing install — the live ISO is the right path for that.
If your first rebuild errors out, the five most common failures and their fixes
live in [Troubleshooting](TROUBLESHOOTING.md).
---
## Fallback: clean install via the live ISO