Personal NixOS flake driving three machines: a workstation, a public VPS and a home server. Built with snowfall-lib, secrets sealed with sops-nix, disks declared with disko.
This is a working configuration, not a framework. The reusable parts — desktop profiles, hardening, Docker relics — live in a separate flake, gfriloux/stc; what stays here is the host-specific layer that wires them together.
| Host | Role | Notable |
|---|---|---|
exampleHost |
Workstation | ZFS mirror, AMD GPU, Plasma 6, gaming profile, YubiKey |
clochette |
Scaleway VPS, public services | Docker, published through the pangolin gateway (newt), SSH over Tailscale only |
RogueLeader |
Home server | Docker, published through the pangolin gateway (newt), Borg backups |
skitarii |
OVH VPS, gateway | pangolin + gerbil + Traefik + CrowdSec, SSH over Tailscale only |
Four Home Manager configurations: kuri@exampleHost, guillaume@clochette,
guillaume@RogueLeader, weechat@clochette (a persistent zellij + WeeChat IRC
session).
Every web container is published by the pangolin gateway on skitarii, which holds the Let's Encrypt certificates and runs CrowdSec in front of it, and is watched by a health poller that kills unhealthy containers so systemd restarts them and pushes a notification to ntfy.sh.
| Service | Host | Domain |
|---|---|---|
| Immich — photo gallery | clochette |
photos.friloux.me |
| CrowdSec Manager — WAF UI | skitarii |
crowdsec.friloux.me (pangolin SSO + TOTP) |
| BookStack — wiki | RogueLeader |
wow-cp.friloux.me |
| Uptime Kuma — monitoring | RogueLeader |
status.friloux.me |
| Papra — document archive | RogueLeader |
docs.friloux.me |
| Mealie — recipes | RogueLeader |
cuisine.friloux.me |
| Borg UI — backup browser | RogueLeader |
borg-ui.friloux.me |
Image tags are pinned and bumped by Renovate, which reads the # renovate
comment next to each image = line. just scan runs Trivy against every image
a host declares.
systems/x86_64-linux/{exampleHost,clochette,RogueLeader}/
default.nix # host entry point, stc profiles, sops declarations
disko.nix # disk layout
docker-*.nix # one file per service, secrets declared alongside
backup.nix # Borg
homes/x86_64-linux/<user>@<host>/
secrets/ # age-encrypted, see .sops.yaml
checks/{nix,gitleaks,markdown}/
docs/ # Astro + Starlight, EN/FR
just build # build exampleHost
just install # switch exampleHost (nh os switch)
just build_clochette
just install_clochette # nixos-rebuild --target-host guillaume@clochette
just build_rogueleader
just install_rogueleader
just home_rogueleader # Home Manager only
just secrets # edit exampleHost secrets
just secrets_clochette
just secrets_rogueleader
just test # pre-commit run --all-files
just update # nix flake updateDeployment goes over SSH as guillaume, using --ask-sudo-password.
clochette is only reachable through Tailscale.
Three age-encrypted files, one per host. Each host decrypts its own file at boot with its own key. Editing goes through two admin keys that never sit in clear on a host: an age identity on a YubiKey (PIV slot, PIN and touch) and an offline rescue key.
| File | Recipients |
|---|---|
secrets/kuri_exampleHost.yaml |
workstation + YubiKey + rescue |
secrets/clochette.yaml |
clochette + YubiKey + rescue |
secrets/RogueLeader.yaml |
RogueLeader + YubiKey + rescue |
The workstation reads its boot key from /etc/sops/age/keys.txt, which only
opens its own file; the two servers derive theirs from their SSH host key.
Reinstalling a host changes its key, which means updating .sops.yaml and
re-running sops updatekeys with the YubiKey. The
docs walk through the whole procedure.
nix flake check runs stc's purity seals:
nix— deadnix, statix, alejandragitleaks— secret scan, allowlist in.gitleaks.tomlmarkdown— rumdl
A pre-commit hook runs the Nix linters as a faster local gate.
Reinstallation procedures for all three machines, secrets backup and restore, Tailscale re-enrollment, per-service guides and troubleshooting: https://gfriloux.github.io/nixos/ (also in French).
just docs-dev # localhost:4321/nixos/
just docs-build