Home Lab

This wiki documents the current homelab, how it is reproduced, and what must still be done manually. The Ansible repository at https://github.com/tuero/homelab-ansible is the source of truth for guest configuration.

Architecture

• Inventory and Services: systems, VMs, IP addresses, names, ports, and storage
• Routing and Access: DNS, Caddy, LAN access, and remote Tailscale request flows
• Proxmox: hypervisor setup, Cloud-Init templates, VM creation, GPU passthrough, and VM backup/restore
• TrueNAS: datasets, shares, and permissions expected by Proxmox and Ansible

Deployment

• Ansible: controller setup, Vault, full deployment, per-VM deployment, and verification
• Services: service-specific configuration and validation
• Docker Compose: common Compose operations

Recovery and Operations

• Backups and Recovery: backup coverage, template and VM restore, appdata restore, and full rebuild order
• Manual Steps: actions that are not currently automated
• Future Proxmox Split: planned move to separate GPU and services hypervisors

Scope

The reproducible path has three layers:

Proxmox and TrueNAS prerequisites
    -> create or restore reachable Ubuntu VMs
    -> run Ansible to configure the guests
    -> restore service appdata when recovering application state

./run.sh configures existing VMs. It does not create Proxmox VMs, configure host PCI passthrough, create TrueNAS datasets, or restore service appdata.