🧪 NixOS Libvirt Kubernetes (Single Node Cluster)

This project provisions a single-node Kubernetes cluster on NixOS using:

• 🛠️ Terraform — to manage virtual machines on Libvirt
• 🐧 NixOS — declarative configuration for VM images
• 🌱 Colmena — to deploy and manage Kubernetes configuration
• 🐳 Libvirt/QEMU — local VM virtualization

✅ Prerequisites

• Nix
• Terraform ≥ 1.0
• Libvirt (with default pool active)
• QEMU/KVM
• SSH configured with ~/.ssh/id_ed25519.pub or ~/.ssh/id_rsa.pub

---

🔧 Setup Instructions

1. Start a Nix Shell

nix-shell

Generate the NixOS Image

make-boot-image

Deploy VM with Terraform

terraform init
terraform apply

Deploy Kubernetes with Colmena

Ensure you can SSH into the VM via the configured key, then:

colmena apply

🧼 Cleanup

terraform destroy

To remove the VM and associated resources.

📖 Resources

• NixOS Kubernetes
• nixos-generators
• Colmena
• Terraform Libvirt Provider