Skip to content

homelab-iac

Proxmox VMs and LXC containers with OpenTofu, a K3s cluster managed by GitOps, and Cloudflare for DNS, certificates and state.

The goal of this homelab is a self-sustaining, reproducible and secure environment to automate the full infrastructure lifecycle, experiment with DevOps and security tooling, host personal services, and practice architecture, automation and observability.

This wiki follows the Diátaxis framework:

Tutorials

Learning-oriented. Start from a fresh Proxmox node and end with a VM managed by OpenTofu. Getting started →

How-to guides

Task-oriented recipes: build templates, deploy VMs and containers, install K3s, expose apps on Hyperion. Browse guides →

Reference

Facts to look up: repository layout, Proxmox permissions, environment variables, components, workflows and Terraform inputs. Open reference →

Explanation

Why things are built the way they are: architecture, the Hyperion and Cronos clusters, remote state, and how these docs are delivered. Read explanations →