You've got the hardware. You've got Proxmox running. Now you want to stop doing everything by hand and start treating your homelab like real infrastructure — repeatable, testable, version-controlled.
That's what homestak is for.
curl -fsSL https://raw.githubusercontent.com/homestak-dev/bootstrap/master/install.sh | bashThis installs the homestak CLI and clones the core repos. From there, you can configure your Proxmox host, provision VMs, and run integration scenarios.
┌─────────────┐
│ bootstrap │ ← curl|bash entry point
└──────┬──────┘
│
┌──────────────────────┼──────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ site-config │ │ iac-driver │ │ ansible │
│ secrets │◄──►│ orchestrate │◄──►│ configure │
└─────────────┘ └──────┬──────┘ └─────────────┘
│
┌─────────────┼─────────────┐
▼ ▼
┌──────────┐ ┌──────────┐
│ tofu │ │ packer │
│ provision│ │ build │
└──────────┘ └──────────┘
bootstrap gets you started. iac-driver orchestrates multi-step workflows. ansible configures hosts. tofu provisions VMs. packer builds custom images. site-config keeps your secrets encrypted and version-controlled.
Fresh Debian/Proxmox Host Running VMs
│ ▲
│ curl|bash │
▼ │
┌───────────┐ ┌───────────┐ ┌───────────┐
│ bootstrap │───►│ ansible │───►│ tofu │
│ install │ │ configure │ │ provision │
└───────────┘ └───────────┘ └───────────┘
Start with a fresh Debian or Proxmox host. Bootstrap installs dependencies and the CLI. Ansible configures the host. Tofu provisions your VMs. Rinse and repeat.
homestak pve-setup # Configure a Proxmox host
homestak scenario vm-roundtrip # Provision → verify → destroy a VM
homestak playbook user -e local_user=me
homestak status # Check your installationThe homestak CLI wraps the underlying tools so you don't have to remember the incantations.
| Repo | What it does |
|---|---|
| bootstrap | Entry point — installs the CLI and clones core repos |
| site-config | Your secrets and site-specific config (SOPS + age encrypted) |
| ansible | Playbooks for PVE host configuration |
| iac-driver | Orchestrates multi-step workflows and integration tests |
| tofu | OpenTofu modules for VM provisioning |
| packer | Build custom Debian cloud images (optional) |
Each repo has its own README and CLAUDE.md with deeper context.
Repeatability over flexibility. We prefer conventions that "just work" over infinite configurability. If you want to tweak everything, you can — but the defaults should get you running.
Debian-rooted, Proxmox-current. The platform is built on Debian, with Proxmox as the virtualization layer. The architecture leaves room for bare QEMU/KVM on Debian if you ever need it.
Testable infrastructure. The integration scenarios in iac-driver actually spin up nested Proxmox environments to validate the full stack. This isn't a collection of scripts — it's tested automation.
homestak builds on excellent open-source projects:
| Component | Third-Party | Purpose |
|---|---|---|
| ansible | lae.proxmox | Proxmox VE installation on Debian |
| tofu | bpg/proxmox | OpenTofu provider for Proxmox API |
| packer | hashicorp/qemu | QEMU builder plugin |
See individual repo READMEs for complete dependency lists.
Apache 2.0