TerraHome/nixos/template-base/README.md

NixOS Proxmox k8s-base Template

This folder contains a Kubernetes-ready NixOS base config for your Proxmox template VM build.

Files

• flake.nix: pins nixos-25.05 and exposes one host config.
• configuration.nix: k8s-base settings for Proxmox guests.

Before first apply

1. Add hardware-configuration.nix from the VM install:
   • nixos-generate-config --root /
   • copy /etc/nixos/hardware-configuration.nix next to configuration.nix

Build/apply example inside the VM

sudo nixos-rebuild switch --flake .#template

Notes

• This pre-installs heavy shared Kubernetes dependencies (containerd + kube tools) to reduce per-node bootstrap time.
• Cloud-init still injects the runtime SSH key and per-node hostname/IP.