# Homelab Kubernetes Pipeline

<!-- Generated from README.md.tmpl by scripts/render-docs. Edit README.md.tmpl and homelab.yml, then regenerate. -->

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

## Quick Start

From the Debian server:

```bash
cd ~/my-homelab-configs
./{{ main_script }} up
```

## Documentation Hub

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

- [Architecture & Infrastructure](docs/architecture.md) - Cluster layout, Networking, and Edge path.
- [Deployment Guide](docs/deployment.md) - Prerequisites, bootstrap flow, and validation.
- [AI Operations](docs/ai-ops.md) - Jeannie AI tools, Evals, and Safety cases.
- [Application Ops](docs/app-ops.md) - App delivery, Gitea, and Website management.
- [Service Catalog](docs/service-catalog.md) - Live inventory of all hosts and services.

## Inventory

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

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

Run `./{{ main_script }} up` and `./{{ main_script }} nuke` only from the Debian homelab server.