999 B
999 B
modules/nixos/server/k3s/
Single-binary K3s cluster role. Lightweight Kubernetes used for the homelab cluster.
Files
k3s/
└── default.nix # skyg.nixos.server.k3s.*
Behaviour
- Enables
services.k3swithrole(serveroragent) and an optionalenvironmentFile(envPath, e.g. for the join token). - Extra flags: disables the bundled servicelb and helm-controller, and writes the kubeconfig
group-readable to the
usersgroup. - Opens the standard control-plane/data-plane ports: 6443, 80, 443, 10250–10252, 8472 (flannel), 51820 (wireguard).
Option Namespace
skyg.nixos.server.k3s.enable
skyg.nixos.server.k3s.role # "server" | "agent" (default "server")
skyg.nixos.server.k3s.envPath # path to environmentFile (e.g. token); "" to skip
Conventions
- K3s and the full
k8s/role are mutually exclusive — a host runs one or the other. - Keep cluster join tokens out of the repo; point
envPathat an agenix-managed file.