My nixos setup
- Nix 98.9%
- Makefile 1.1%
|
All checks were successful
deploy / switch-server (push) Successful in 47s
Reviewed-on: #19 |
||
|---|---|---|
| .forgejo/workflows | ||
| devices | ||
| docs | ||
| modules | ||
| secrets | ||
| .gitignore | ||
| .sops.yaml | ||
| AGENTS.md | ||
| flake.lock | ||
| flake.nix | ||
| Makefile | ||
| README.md | ||
NixOS Homelab — Polensky
Configuration NixOS en flake pour tous les machines du foyer : le serveur homelab, les laptops, le Raspberry Pi.
Agents (Lauria/Hermes) : lisez
AGENTS.md— c'est le guide d'opération (permissions, workflows, conventions). Cette doc est pour les humains (et pour tout le monde).
Machines (flake.nix → nixosConfigurations)
| Host | Cible | Rôle |
|---|---|---|
server |
192.168.1.241 (polensky.me) |
Homelab : tous les services web (Caddy, Forgejo, Mealie, Gramps, Jellyfin, Grafana/Prometheus, SearXNG, PocketBase, ntfy, Hermes agent, mining XMR) |
asus |
— | Laptop (backup Immich → Storj via rclone) |
xps13 |
— | Laptop (Dell XPS 13 9370, default) |
latoure |
— | Vielle tour de gaming qui a pu de RAM (act as a NAS) |
macbook |
— | (config minimale) |
pi |
— | Raspberry Pi (image SD card buildable via make build-pi-image) |
Toutes les machines partagent modules/ (sauf ajouts spécifiques dans
le flake pour server : disko, sops-nix, hermes-agent, prixdugaz).
Structure
flake.nix # inputs + nixosConfigurations
Makefile # deploy-* / build-pi-image / register-miner
AGENTS.md # guide d'opération pour les agents
devices/<host>/configuration.nix + hardware-configuration.nix
modules/ # modules NixOS partagés entre les machines
secrets/secrets.yaml # SOPS (age via host key) — secrets des hosts
docs/ # documentation détaillée
Quick start
# Tester une modification (ne touche pas au système qui roule)
nixos-rebuild build --flake .#server
# Déployer sur le serveur (depuis une machine avec les droits sudo)
sudo nixos-rebuild switch --flake .#server
# Ou via Makefile (déploiement à distance, demande le mot de passe sudo)
make deploy-server
Rollback en cas de pépin : nixos-rebuild switch --rollback ou choisir
la génération au boot (GRUB).
Points d'entrée importants
- Services du serveur :
docs/server.md - Modules NixOS :
docs/modules.md - Déploiement & workflows :
docs/deployment.md - Autonomie de l'agent Hermes :
docs/agent-autonomy.md
Conventions
- Un module
modules/*.nix= un service autonome — le service et ses dépendances vivent dans son fichier, avec les commentaires qui expliquent les choix et les pièges rencontrés. - Secrets : jamais dans le nix store. Soit SOPS (
secrets/), soit un fichier à un chemin fixe sur le host (ex.~/.storj-gramps.env) injecté viaenvironmentFiles— jamais de secret en clair dans le code, dans le chat ou dans une PR. - Tout est déclaratif : pas de
docker composemanuel flottant, pas de fichier de config édité à la main sur le host. Si ce n'est pas dans le repo, ça n'existe pas.