Skip to content
gfrilouxPublic

About

Personal NixOS flake (snowfall-lib) for 3 machines: an AMD/ZFS/Plasma 6 workstation, a Scaleway VPS running Docker services behind Traefik + CrowdSec, and a home server. sops-nix secrets, disko, Borg backups, bilingual docs.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

nixos

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.

Docs nixpkgs License

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.

Machines

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).

Services

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.

Layout

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

Usage

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 update

Deployment goes over SSH as guillaume, using --ask-sudo-password. clochette is only reachable through Tailscale.

Secrets

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.

Checks

nix flake check runs stc's purity seals:

  • nix — deadnix, statix, alejandra
  • gitleaks — secret scan, allowlist in .gitleaks.toml
  • markdown — rumdl

A pre-commit hook runs the Nix linters as a faster local gate.

Documentation

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

License

Apache-2.0

About

Personal NixOS flake (snowfall-lib) for 3 machines: an AMD/ZFS/Plasma 6 workstation, a Scaleway VPS running Docker services behind Traefik + CrowdSec, and a home server. sops-nix secrets, disko, Borg backups, bilingual docs.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages