One command. Fresh Proxmox host to running VMs — repeatable, testable, version-controlled.
curl -fsSL https://raw.githubusercontent.com/homestak-dev/bootstrap/master/install.sh | bash
Define your infrastructure as a manifest — nodes, types, sizes, parent relationships — and let the orchestration engine handle the rest.
# A PVE hypervisor with a VM running inside it
nodes:
- name: root-pve
type: pve
preset: vm-large
image: pve-9
- name: app-server
type: vm
preset: vm-small
image: debian-12
parent: root-pve
execution:
mode: pull # async — self-configures on first boothomestak manifest apply -M my-topology -H my-hostThe engine walks the node graph, provisions in dependency order, and configures each node. Two deployment models: synchronous (push config over SSH, wait for completion) or asynchronous (provision with a signed token, node self-configures on first boot). Supports N-level nesting: PVE inside PVE inside PVE, with VMs at any level.
- Manifest-driven orchestration — graph-based topologies with N-level nested PVE support
- Sync and async deployment — push config over SSH or let nodes self-configure on first boot
- Pre-built VM images — custom Debian and PVE images that boot in ~16 seconds
- Encrypted secrets — SOPS + age, version-controlled alongside your config
- Integration tested — real Proxmox environments validate the full stack, not just unit tests
curl | bash site-config (secrets + topology)
│ │
▼ ▼
bootstrap ──► iac-driver ──► ansible ──► configured host
│
├──► tofu ──► provisioned VMs
└──► packer ──► custom images
Bootstrap installs the CLI and clones the repos. iac-driver orchestrates everything — it reads your manifests, resolves config from site-config, and coordinates ansible, tofu, and packer to get you from bare metal to running VMs.
| Repo | Purpose |
|---|---|
| bootstrap | Entry point — installs the CLI and clones core repos |
| site-config | Secrets, manifests, specs, presets, and site-specific config |
| iac-driver | Orchestration engine — manifest-driven node lifecycle |
| ansible | Playbooks for PVE host and VM configuration |
| tofu | OpenTofu modules for VM provisioning |
| packer | Custom Debian cloud images (optional) |
Repeatability over flexibility. Sensible defaults that just work. Tweak everything if you want — but you shouldn't have to.
Debian-rooted, Proxmox-current. Built on Debian with Proxmox as the virtualization layer. The architecture leaves room for bare QEMU/KVM if you ever need it.
Testable infrastructure. This isn't a collection of scripts. Integration tests spin up real Proxmox environments and validate the full stack — from bootstrap through provisioning to configuration.
Apache 2.0