homelab-codex-ws/docs/topology.md

Homelab Topology

Nodes

Node	Role
SATURN	Control and development node
PIHA	Infrastructure and monitoring node
SOLARIA	AI and compute node
VPS	Public ingress and edge node
CHELSTY	Virtualization and Home Assistant node

Architecture Principles

• Git is the source of truth.
• SATURN is the primary orchestration and commit node.
• Runtime state lives outside repositories.
• Tailscale provides internal mesh networking.
• Docker Compose remains the deployment model.
• Public ingress is centralized on VPS.
• Deployment uses lightweight shell scripts.
• Avoid Kubernetes and heavy orchestration frameworks.

Runtime Layout

Runtime data should live under:

/opt/homelab

with separated:

• services
• data
• config
• logs