Homelab infrastructure configuration

Go to file

juvenal.diaz 76a4cefda6 Homelab Main / validate (push) Waiting to run Details Homelab Main / deploy (push) Blocked by required conditions Details Fix Pimox showcmd awk validation		2026-09-25 12:53:36 -06:00
.gitea/workflows	fix: prevent accidental rebuild-cluster in CI by defaulting to 'none' when kubeconfig is missing	2026-09-18 14:51:12 -05:00
apps	ci: add graphiphy repo mapping to up pipeline	2026-09-18 22:12:48 -05:00
archive/apps/arr-stack	Archive legacy ARR Kubernetes manifests	2026-06-29 21:02:11 -06:00
bootstrap	fix: resolve jeannie CI failures, add gitleaks ignore, apply ruff fixes, make scripts executable	2026-09-20 00:29:43 -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
graphify-out	ci: add graphiphy repo mapping to up pipeline	2026-09-18 22:12:48 -05:00
infra	Fix homelab up worker and omniroute blockers	2026-09-25 12:15:37 -06:00
labs	fix: resolve jeannie CI failures, add gitleaks ignore, apply ruff fixes, make scripts executable	2026-09-20 00:29:43 -05:00
lib/jeannie	Fix Pimox showcmd awk validation	2026-09-25 12:53:36 -06:00
scripts	Fix homelab up worker and omniroute blockers	2026-09-25 12:15:37 -06:00
security	Add prompt injection lab	2026-06-30 11:48:08 -06:00
tests	Fix jeannie helper sourcing and validation	2026-09-25 11:41:23 -06:00
.gitignore	Edge matrix vhost, node-exporter scrape, arr/rpi refinements	2026-09-16 11:37:35 -05:00
.gitleaks.toml	fix: resolve jeannie CI failures, add gitleaks ignore, apply ruff fixes, make scripts executable	2026-09-20 00:29:43 -05:00
.gitleaksignore	fix: resolve jeannie CI failures, add gitleaks ignore, apply ruff fixes, make scripts executable	2026-09-20 00:29:43 -05:00
.modularization_checkpoint	chore: modularization checkpoint	2026-09-18 23:15:22 -05:00
.pre-commit-config.yaml	chore: add tflint to playbook and gitleaks ignore cache	2026-09-19 20:19:52 -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	Fix jeannie helper sourcing and validation	2026-09-25 11:41:23 -06: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.