homelab-codex-ws/docs/topology.md
2026-05-10 22:05:16 +02:00

35 lines
779 B
Markdown

# 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