Run the setup wizard on Proxmox.
Kubernetes on your own hardware
One command starts the cluster. The rest stays explicit.
Twinbox turns a Proxmox server into a fully configured Talos Linux cluster with GitOps, secrets, storage, backups, ingress, and management tooling. The public site lives here. The installation wizard runs separately inside the Management VM.
- Bootstrap
- Proxmox host first, guided wizard second
- Control plane
- Talos-based and API driven
- Operations
- GitOps, secrets, storage, backups, ingress
What you start with
Any Proxmox host with virtualization support
The workflow is designed for old servers, workstations, or fresh builds. Twinbox provisions the Management VM and hands off the rest to the web wizard.
Management VM boots the stack and web UI.
Provision Talos and finish the cluster in the browser.
What Twinbox does
Public marketing page and live wizard are separate surfaces.
This page is only the public landing experience. The actual installation wizard is the React app that runs in Docker on the Management VM after bootstrap.
Proxmox bootstrap
One command on the Proxmox console creates the Management VM and prepares the management environment.
Talos cluster lifecycle
The wizard sizes the cluster, lands the VMs, and records state so the journey stays repeatable.
GitOps-first platform
Argo CD manages the cluster platform, keeping applications and infrastructure changes visible in Git.
Secrets and storage
OpenBao, External Secrets Operator, and Longhorn provide the operational baseline for workloads.
Ingress and routing
Traefik exposes the services, while the platform config remains explicit and cluster-scoped.
Backups and observability
Velero and the surrounding platform tooling keep recovery and day-two operations part of the design.
Platform stack
Built around the pieces operators actually need.
The cluster is meant to stay understandable under pressure. Each layer has one responsibility and one place in the flow.
Talos LinuxImmutable Kubernetes host operating system
CiliumNetworking and policy-ready datapath
Argo CDGitOps for the entire platform
LonghornDistributed block storage
OpenBao + ESOCentralized secret management
TraefikIngress and routing
VeleroCluster backups
CloudNativePGManaged PostgreSQL clusters
Installation flow
Three clear stages, no ambiguity about where each page lives.
Run the Proxmox wizard
Start on the host, create the Management VM, and let the bootstrap script prepare Docker and the Twinbox runtime.
Open the Management VM web app
The React wizard runs on port 3000 inside Docker and guides the cluster provisioning journey.
Provision and install the platform
The worker executes repo-owned scripts, the cluster lands, and the platform services come online in order.
Next step
Open the guide, then run the installer where it belongs.
The public page is only the front door. The actual wizard stays on the Management VM and the repository docs describe the bootstrap path.