This repository contains the architectural documentation, system design decisions, and operational runbooks for my homelab infrastructure.
It will document the architecture, rebuild process, and operational philosophy behind a fully automated, reproducible private infrastructure stack.
Reproducible, Infrastructure-as-Code driven private cloud built on Proxmox and Oracle Cloud
Provisioning and configuration live in separate repositories. This repository is the authoritative documentation and system reference.
| Repository | Responsibility |
|---|---|
| Infra Lab (OCI WIP) | Infrastructure Provisioning |
| Ansible Lab (WIP) | Configuration Management |
| Services | Docker Compose Stacks and Scripts |
| Archive Docs | Currently Archived Docs for lab |
Separation ensures clean lifecycle boundaries between provisioning and configuration.
The infra is built with strict separation of concerns:
| Layer | Tech |
|---|---|
| Hypervisor | Proxmox |
| Cloud | Oracle Cloud |
| Provisioning | OpenTofu |
| Configuration | Ansible |
| Core Services | Firewall, DNS, overlay networking |
Repository Purpose:
- Architecture documentation
- Network topology explanations
- DNS flow documentation
- Disaster recovery procedures
- Design rationale
- Rebuild instructions
- System diagrams