Nathan
54a885120d
- Compose file with pinned images (v0.16.6.1), healthchecks, Traefik routing - .env.example with all required variables and generation commands - README covering access, appdata, backup scope, upgrade procedure - KBA-002: deployment reference with verification and rollback steps - repo-deploy.prompt.md: reusable end-to-end deployment workflow prompt - Session snapshot 2026-05-10 Source: https://github.com/CodeWithCJ/SparkyFitness
Castaldi Family Homelab
A GitOps-managed, Ansible-automated infrastructure running media services, container orchestration, and hypervisor management across distributed ARM and x86 nodes.
🚀 Why This Homelab?
- Zero-Touch Deployments: Push to Git → Auto-deploy via webhooks → Containers update automatically
- Ansible Automation: All nodes managed by Ansible from watchtower control plane
- Infrastructure as Code: Services defined in
compose.yaml+ infrastructure managed with Ansible playbooks - GPU Transcoding: Hardware-accelerated media streaming with NVIDIA GTX 1060 Mobile
- Distributed Architecture: Services across physical servers with Proxmox hypervisor ready for VM deployment
- Self-Hosted Git: No external dependencies—Gitea runs on-premise with automated backups
- Production-Grade Networking: Traefik reverse proxy with automatic SSL (Cloudflare DNS challenge)
- Hypervisor Management: Proxmox VE ready for VM orchestration with automated post-install configuration
📊 Stats
- Total Nodes: 5 (1 hypervisor + 3 compute + 1 storage)
- Automation: Ansible managing 4 active nodes from Watchtower
- Container Orchestration: Komodo v2.1.2
- Active Services: 12+ (Traefik, Plex, Tunarr, Gitea, Trek, Vaultwarden, etc.)
- Total RAM: 62GB (15GB PVE01 + 15GB Heimdall + 16GB Waldorf + 16GB Watchtower)
- Total CPU Cores: 30 physical (14c i5-13500T + 8c i7-7820HQ + 4c N100 + 4c ARM)
- Virtualization: Proxmox VE 9.1.7 available (no VMs currently deployed)
- GPU Acceleration: NVIDIA GTX 1060 Mobile (6GB VRAM)
- Storage: TerraMaster NAS (NFSv3/v4)
🤝 Contributing
This is a personal homelab, but documentation improvements and issue reports are welcome!
- Fork via Gitea:
https://git.castaldifamily.com/nathan/homelab - Create feature branch:
git checkout -b feat/my-improvement - Commit using Conventional Commits
- Push and create Pull Request
📜 License
Personal infrastructure configuration. Documentation licensed under CC BY-SA 4.0.
Maintained by: Nathan Castaldi
Last Updated: April 21, 2026
Status: 🟢
Automation Status: 🟢