Homelab infrastructure configuration

Go to file

jv 4f8ba24f06 Homelab Main / validate (push) Failing after 5s Details Homelab Main / deploy (push) Has been skipped Details fix: install python3-pip and python3-yaml via apt		2026-09-18 09:57:24 -05:00
.gitea/workflows	fix: install python3-pip and python3-yaml via apt	2026-09-18 09:57:24 -05:00
apps	fix: add k8s label to runner to match workflow	2026-09-17 21:53:01 -05:00
archive/apps/arr-stack	Archive legacy ARR Kubernetes manifests	2026-06-29 21:02:11 -06:00
bootstrap	Platform: re-keyscan Argo CD GitOps SSH host on every apply	2026-09-16 11:54:25 -05:00
cmd/jeannie-core	Run independent Jeannie up tasks in parallel	2026-07-01 14:01:58 -06:00
docs	Fix render script filename extension bug	2026-09-16 22:17:52 -05:00
infra	Edge matrix vhost, node-exporter scrape, arr/rpi refinements	2026-09-16 11:37:35 -05:00
labs	Move inactive MLOps app to labs	2026-06-29 21:04:37 -06:00
scripts	Fix render script filename extension bug	2026-09-16 22:17:52 -05:00
security	Add prompt injection lab	2026-06-30 11:48:08 -06:00
tests	Default cluster workers to Pimox only	2026-07-01 19:12:37 -06:00
.gitignore	Edge matrix vhost, node-exporter scrape, arr/rpi refinements	2026-09-16 11:37:35 -05:00
.sops.yaml	Add Matrix/Hermes/Omniroute to jeannie pipeline (SOPS-encrypted secrets)	2026-09-16 11:37:13 -05:00
.sops.yaml.example	Add SOPS age secret management bootstrap	2026-06-27 17:27:05 -06:00
README.md	Modularize documentation and add architecture diagram	2026-09-16 22:00:00 -05:00
README.md.tmpl	Modularize documentation and add architecture diagram	2026-09-16 22:00:00 -05:00
go.mod	Start Jeannie Go core migration	2026-07-01 08:49:43 -06:00
homelab.yml	chore: update website blog with worker-03 expansion and sync homelab.yml	2026-09-17 16:04:20 -05:00
jeannie	Add Matrix/Hermes/Omniroute to jeannie pipeline (SOPS-encrypted secrets)	2026-09-16 11:37:13 -05:00
renovate.json	Add generated docs config	2026-06-27 15:42:59 -06:00

README.md

Homelab Kubernetes Pipeline

This repo bootstraps a hybrid kubeadm cluster and then hands app delivery to Argo CD.

Quick Start

From the Debian server:

cd ~/my-homelab-configs
./jeannie up

Documentation Hub

The detailed technical specifications have been moved to the /docs directory:

Architecture & Infrastructure - Cluster layout, Networking, and Edge path.
Deployment Guide - Prerequisites, bootstrap flow, and validation.
AI Operations - Jeannie AI tools, Evals, and Safety cases.
Application Ops - App delivery, Gitea, and Website management.
Service Catalog - Live inventory of all hosts and services.

Inventory

The canonical non-secret inventory is homelab.yml. Keep LAN IPs, Tailscale IPs, public hostnames, ports, storage paths, and service ownership there.

./jeannie reads homelab.yml at startup and exports matching OpenTofu variables. scripts/render-docs renders the documentation and the static service catalog page.

Run ./jeannie up and ./jeannie nuke only from the Debian homelab server.