My nixos setup
  • Nix 98.9%
  • Makefile 1.1%
Find a file
2026-11-21 11:29:22 -05:00
.forgejo/workflows budget-service - docs(deploy): note AGit PRs run without secrets 2026-11-14 01:07:51 -05:00
devices macbook-tailnet-resolver - fix(macbook): resolve tailnet names through MagicDNS 2026-11-21 10:58:05 -05:00
docs tailnet-up-flags - docs(server): repeat the tailscale flags on the first tailscale up 2026-11-21 11:12:19 -05:00
modules deploy-success-notif - feat(server): notify ntfy on successful deploy 2026-11-14 00:25:08 -05:00
secrets deploy key 2026-11-13 23:54:38 -05:00
.gitignore toure/server setup enhance 2025-11-21 12:23:39 -05:00
.sops.yaml MONERO FLEETONLINE 2026-09-20 01:39:01 -04:00
AGENTS.md feat(server): self-host a tailnet with Headscale 2026-11-19 17:59:57 -05:00
flake.lock budget-service - feat(server): add the Budget service behind budget.polensky.me 2026-11-14 00:48:36 -05:00
flake.nix budget-service - feat(server): add the Budget service behind budget.polensky.me 2026-11-14 00:48:36 -05:00
Makefile x time the charm 2026-10-05 23:36:37 -04:00
README.md Update README.md 2026-10-14 10:08:47 -04:00

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

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é via environmentFiles — jamais de secret en clair dans le code, dans le chat ou dans une PR.
  • Tout est déclaratif : pas de docker compose manuel flottant, pas de fichier de config édité à la main sur le host. Si ce n'est pas dans le repo, ça n'existe pas.