One command. Fresh Proxmox host to running VMs — repeatable, testable, version-controlled.

curl -fsSL https://raw.githubusercontent.com/homestak/bootstrap/master/install | 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 boot

homestak manifest apply -M my-topology -H my-host

The 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                    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, and coordinates ansible, tofu, and packer to get you from bare metal to running VMs.

homestak — Core

homestak-iac — Infrastructure automation

homestak-dev — Developer experience

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