Kubernetes Homelab Automation and Helm Charts

Minimal helm chart wrappers for minimal home lab setups. Matches my k3s setup.

Chart Usage

Add the helm repo:

helm repo add clux https://clux.github.io/homelab

then helm search repo clux to see the charts.

Charts

• promstack :: A low-footprint prometheus/observability chart
• cx-dashboards :: A set of modern dashboards for small clusters with prometheus backlinks
• flux :: Minimal flux for gitops from this repo
• renovate :: Minimal renovate running clux/renovate
• forgejo :: Basic forgejo setup (no runners)
• cilium :: Basic cilium for k3s with hubble replacing kube-proxy
• coredns :: Basic coredns with minor diverging elements from k3s

Cluster Setup

If following these charts, they are made for k3s server with the following minimal configuration in /etc/rancher/k3s/config.yaml:

disable:
- traefik
- servicelb
- coredns
- helm-controller
disable-network-policy: true
# api server pin to the main host
node-ip: 192.168.1.40
https-listen-port: 6443
# defaults
cluster-cidr: 10.42.0.0/24
service-cidr: 10.43.0.0/16
# cilium takeover
disable-kube-proxy: true
flannel-backend: none

Cluster Bootstrap

Given a fresh k3s cluster, apply the crds and network stack, inject the config above, and restart k3s.service

just crds # apply crds folder
just network # install coredns and cilium

Then flux based applications can be kubectl apply'd from the bootstrap directory.