Commit `a779da9ae492`

Vincent Demeester <vincent@sbr.pm>

2026-06-10 22:44:20

docs: document Fedora home-manager workflow

Clarified that the make switch / nixos-rebuild rule applies to NixOS hosts only, and documented the standalone home-manager and system-manager commands used on non-NixOS hosts such as aomi.

main

1 parent 0e3a3b0

Changed files (1)

AGENTS.md

@@ -22,7 +22,22 @@ This is my homelab git repository. It is a comprehensive NixOS and home-manager
   - Past tense.
   - State **what** and **why** only (no "how").
 
-- **IMPORTANT: Never use `home-manager switch` or `nixos-rebuild` commands directly. Always use `make switch` or the appropriate make targets.**
+- **IMPORTANT: On NixOS hosts, never use `home-manager switch` or `nixos-rebuild` directly. Always use `make switch` or the appropriate make targets (home is built as part of the NixOS system).**
+
+### Non-NixOS hosts (Fedora CSB, e.g. `aomi`)
+
+Some hosts (like `aomi`) run **Fedora**, not NixOS. They have **no** `make switch` /
+`nixos-rebuild` workflow. Instead they use standalone **home-manager** plus
+**system-manager**:
+
+- Home config (shell, editors, dev tools, ssh, etc.):
+  - `home-manager switch --flake .#vdemeest@aomi`
+  - or `nix run home-manager -- switch --flake .#vdemeest@aomi`
+- System config (system-manager):
+  - `nix build .#systemConfigs.aomi && sudo ./result/bin/activate`
+- Bootstrap reference: `imperative/aomi/`
+- Detect a Fedora/non-NixOS host with `test -e /etc/NIXOS` (absent ⇒ Fedora).
+- **Do NOT run `make switch` on these hosts** — it invokes `nixos-rebuild` and will not work.
 
 ## Architecture

Commit a779da9ae492

Commit `a779da9ae492`