Homelab documentation

Single source of truth for the machines, network, and services that make up the homelab. Published from the gperdrizet/homelab repository.

The machines

Machine	Role	Status
gatekeeper	Public VPS: ingress, TLS, monitoring, app hosting	Active
pyrite	Workstation: development, GPU compute, core services	Active
arkk	NAS: RAID storage, backup target	Recovering

Start here

• Looking for a service? Gatekeeper service and port inventory and services on pyrite
• How machines connect: Network overview
• Day-2 operations: Operations index — backups, secrets, docker images
• Active incident: arkk RAID recovery and backup triage

Design principles

• Private by default — services live on the tailnet; public ingress terminates on gatekeeper only.
• Secrets stay out of git — .env.template committed, real values in Vaultwarden. See secrets management.
• Every operational change documents decision, apply steps, verify steps, and revert path.

Related repositories

Repo	Contents
llama.cpp	Inference server on pyrite (port 8502)
postgreSQL-server	Multi-tenant PostgreSQL on pyrite
nixx	nixx server on pyrite (port 8000)
docker-images	Custom base images on GHCR

Local preview

pip install mkdocs-material
mkdocs serve

Then open http://127.0.0.1:8000.