This repo the setup for my homelab.

It currently consists of single bare-metal server running NixOS, with k3s to deploy containers.

This is for my own usage and preferences, but you are of course free to use it as inspiration.

• cluster
  • definition of all services running in the cluster
• host
  • configuration files for server
• setup
  • notes for setting up my homelab

• AMD Ryzen 5 5600G
• ASRock A520M-ITX/ac
• 16GB
• a few TB disc space

My homelab runs NixOS.

There 2 services directly running and configured on the host: WireGuard, for accessing my homelab from the outside, and dnsmasq, for resolving hostnames.

Most other services run in a Kubernetes cluster. To deploy it I use k3s. The cluster is managed with argoCD, which watches the cluster directory for changes and automatically applies them to the cluster.

Storage and backups are managed with longhorn. Secrets are handled using ksops.

Renovate automatically creates pull requests for updating dependencies.

There are also a few configs for linting and corresponding github-actions that lint new pull requests.