Skip to content

NgarumaVTC/nixos

Repository files navigation

NgarumaVTC — NixOS Configuration

The declarative NixOS configuration for the KaziLab school server at Ngaruma Vocational Training Centre, Kilimanjaro Region, Tanzania.

One flake. One rebuild. Twenty students online.

Structure

flake.nix              Flake entry point (nixpkgs-unstable + sops-nix)
hosts/mkuu1/           Server host configuration  (mkuu = "the chief", Swahili)
common/
  network.nix          Single source of truth: all IPs, MACs, VLANs
  containers.nix       systemd-nspawn container definitions
  ct.nix               Shared container base module
users/
  ramge/               Admin SSH keys
  students.csv         Student roster (bulk import via provision-students.sh)
  provision-students.sh

Usage

# Rebuild and switch on the server
sudo nixos-rebuild switch --flake .#mkuu1

# Roll back if something breaks
sudo nixos-rebuild switch --rollback

Links

License

MIT — do whatever you want with it. A mention is appreciated.