Gitops repository controlling talos linux k8s cluster
  • Python 83%
  • Dockerfile 8.7%
  • Shell 8.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-21 02:18:29 -08:00
.forgejo/workflows Merge branch 'main' into renovate/talos-mcp-server 2026-11-20 11:50:30 -08:00
docs docs: talos-mcp v4 read-only tool set 2026-11-21 10:16:19 +00:00
gitops Merge pull request 'Update Helm release kube-prometheus-stack to v93.6.1' (#396) from renovate/kube-prometheus-stack-93.x into main 2026-11-21 01:38:36 -08:00
images/turnstone chore(deps): update dependency turnstonelabs/turnstone to v1.9.4 2026-11-09 07:49:26 +00:00
scripts edge-routes: generate farnsworth's Traefik passthrough routes 2026-10-05 21:52:22 -07:00
talos Update talos-mcp-server to v4.0.1 2026-11-20 19:43:51 +00:00
.gitignore enable ansible nightly job and fix home assistant link in homepage 2026-11-14 13:25:43 -08:00
LICENSE Initial commit 2026-09-01 23:43:50 -07:00
README.md Docs: move the app and infrastructure READMEs into docs/ 2026-11-14 13:21:25 -08:00
renovate.json Docs: move the app and infrastructure READMEs into docs/ 2026-11-14 13:21:25 -08:00

talos-gitops (n100-talos-cluster)

A 3-node Talos Linux Kubernetes cluster on N100 mini PCs, managed by Argo CD. This repo is the source of truth for the Talos machine config and everything running on the cluster. It also builds a few images and runs jobs for hosts outside the cluster.

  • Cluster name clusterfuck, API https://192.168.1.200:6443, nodes 192.168.1.200-202 (all control plane, all schedulable).
  • LoadBalancer IPs 192.168.1.40-45 (Cilium L2): .40 Ingress, .44 Prometheus remote write, .45 Loki push.
  • Internal apps are https://<app>.k8s.internal.nonmundane.org; public ones https://<app>.nonmundane.org through farnsworth's Traefik.

Layout

talos/                   Talos machine config: gen-config.sh, patches/, talos-mcp image
images/turnstone/        Patched Turnstone image (runs on farnsworth)
gitops/
  clusters/n100/         App-of-apps root
  infrastructure/        Argo CD, Cilium, Longhorn, cert-manager, external-dns, External Secrets,
                         CloudNativePG, Prometheus/Grafana, Loki, Alloy, Headlamp, metrics-server
  apps/                  Workloads. Each folder becomes an Argo CD Application of the same name,
                         in a namespace of the same name (apps-appset.yaml)
docs/                    The documents below
docs/templates/          Reference manifests, kept out of gitops/apps/ so they aren't deployed
scripts/                 render-edge-routes.py (public routes for farnsworth's Traefik)
.forgejo/workflows/      Renovate (for this repo and homelab-compose), edge-routes, image builds

Day to day

  • Change something: edit, commit, push. Argo CD reconciles. Never kubectl edit or kubectl scale a managed resource: selfHeal reverts it within one sync.
  • Add an app: create gitops/apps/<name>/ with plain manifests. No metadata.namespace needed there. Every pod must declare requests and limits (namespace ResourceQuota).
  • Secrets: AWS Secrets Manager under the nonmundane/ prefix, region us-west-2, pulled by an ExternalSecret from the ClusterSecretStore named aws-secretsmanager (no hyphen in "secretsmanager").
  • Not applied by a push: gitops/infrastructure/argocd (apply by hand), Cilium's Helm values (helm upgrade), and Longhorn (manual sync). See bootstrap.md.
  • Image updates: Renovate runs daily at 06:00 UTC. PRs labelled manual-review or manual-apply-required need a step from you after merging; the PR's rule description in renovate.json says which.

Docs

doc covers
bootstrap.md rebuilding the cluster from nothing; upgrading Argo CD; Cilium, cert-manager, external-dns, Longhorn
observability.md Prometheus, Grafana, Loki, Alloy; how the Compose hosts and forbin report in
public-apps.md exposing an app through farnsworth's Traefik; Basic Auth; IP allowlists
backups.md what is backed up to Garage, and how to add a volume or database
migrating.md moving a service from Docker Compose onto the cluster
apps.md per-app notes: what is unusual about each workload
farnsworth-services.md talos-mcp, kubernetes-mcp, grafana-mcp and Turnstone: images built here, run on farnsworth
troubleshooting.md problems hit more than once. Read before debugging from scratch
homelab-maint.md nightly OS updates and reboots of forbin, the Pis and farnsworth
webhook.md the torrent-completion webhook: setup and gotchas
ddns-updater.md home.nonmundane.org and the AWS setup behind it
sl-presence.md the Second Life presence poller and its Grafana dashboard
kubernetes-mcp.md building kubernetes-mcp's read-only kubeconfig

All documentation is in docs/; there are no READMEs under gitops/.

Known gaps

  • Restores are untested (backups.md).
  • Backups are on the same LAN as the cluster; there is no off-site copy.