2026-10-02 22:18:58 -04:00
2024-07-03 11:48:50 -04:00
2026-08-31 11:02:35 -04:00
2026-02-14 08:47:38 -05:00
2026-02-16 16:22:45 -05:00
2025-07-27 22:42:13 -04:00
2026-10-02 22:18:58 -04:00
2026-10-02 22:13:33 -04:00
2026-07-17 23:28:34 -04:00
2025-05-11 16:13:40 -04:00
2025-02-23 15:38:29 -05:00
2025-07-27 22:12:56 -04:00
2025-12-23 15:25:11 -05:00
2026-02-16 16:22:45 -05:00
2026-08-31 11:02:35 -04:00
2025-05-11 16:13:40 -04:00
2026-02-14 08:47:38 -05:00
2025-04-22 17:27:38 -04:00
2025-05-04 10:26:42 -04:00
2025-08-03 22:02:10 -04:00
2025-04-14 22:26:00 -04:00
2026-02-14 08:47:38 -05:00

(My) Homelab

A GitOps-driven Kubernetes (k3s) homelab, provisioned with Nix, Terraform, Helm, and Argo CD.

Argo CD watches this repo and syncs the applications defined under charts/, while Terraform bootstraps the cluster plugins and manages Cloudflare DNS.

Documentation

See docs/DOCUMENTATION.md for the full guide covering:

  • Architecture overview (Terraform + Argo CD + GitOps flow)
  • Getting started / prerequisites
  • Terraform configuration & variables
  • The bin/dev helper CLI
  • Every Helm chart (infrastructure, apps, ingress, argoapps)
  • Secrets management & External Secrets
  • OS configuration (Raspberry Pi, OpenWrt routers)

Quick status

Area Tooling
Dev environment Nix (flake.nix)
Provisioning Terraform (tf-*.tf)
Cluster plugins Helm via tf-modules/k8s-helm-charts
GitOps Argo CD (charts/infrastructure)
DNS Cloudflare (tf-dns.tf)

Repository Structure

  • bin/ – helper scripts (CLI at bin/dev)
  • certs/ – TLS certificates
  • charts/ – Helm charts (apps/, infrastructure/)
  • docs/ – documentation
  • os/ – OS-specific configuration
  • tf-modules/ – reusable Terraform modules
  • tf-*.tf – Terraform configuration files

Getting Started

This repo uses Nix + Terraform to provision a homelab infrastructure.

  1. Bootstrap the environment: nix develop
  2. Initialise Terraform: terraform init
  3. Review the plan: terraform plan
  4. Apply the configuration: terraform apply

Requires a k3s cluster configured as the homelab kubectl context, plus Cloudflare API tokens.

Usage

  • Edit var.auto.tfvars for environment-specific values.
  • Run ./bin/ scripts to deploy services.
  • Use terraform state commands to inspect resources.
  • Argo CD auto-syncs applications from charts/apps/*.
S
Description
No description provided
Readme
1.5 MiB
0 Stars 1 Watchers 0 Forks
Languages
Shell 36.9%
HCL 30.7%
Go Template 26.9%
Nix 3.6%
CSS 1.9%