[ open-source cockpit / homelab & dev / multi-provider ]
Your topology, described once. Rebuilt whenever you need.
DevStation is an open-source cockpit for engineering. Topologies, its first feature, models, provisions and recreates homelab and development environments — multi-provider by design, with Proxmox today.
$
View on GitHub curl -fsSL https://raw.githubusercontent.com/devstationtech/devstation/main/install.sh | sh devstation@homelab ~ $ devstation
session 04:12
topologies › homelab-demo
nodes provisioning
● proxmox connected — demo.devstation.local
name ip cpu ram (GiB) system disk (GiB) uptime vms
❯ ● node-01 10.42.0.11 31d 04h 4
❯ ● node-02 10.42.0.12 31d 02h 4
❯ ● node-03 10.42.0.21 6h 18m 2
❯ ● storage-01 10.42.0.31 18d 22h 2
❯ ● storage-02 10.42.0.41 18d 22h 1
❯ ● gpu-01 10.42.0.51 2d 11h 4
● running ● stopped ● not found
↵ open r register e edit u unregister x unregister all ←→ tabs d disconnect esc back
topologies › homelab-demo › node-01
virtual machines images
name vmid tags ip cpu ram (GiB) disk (GiB) uptime
❯ ● k3s-01 101 k3s 10.42.10.11 6h 12m
● k3s-02 102 k3s 10.42.10.12 6h 11m
● db-01 121 db 10.42.20.21 4h 48m
● db-02 122 db 10.42.20.22 —
● running ● stopped ● not found
↵ open r register e edit u unregister x unregister all ←→ tabs esc back
topologies › homelab-demo › node-01 › virtual machines › k3s-01
● k3s-01 vmid 101 10.42.10.11 k3s running 6h 12m
1h 1d 7d
cpu (%) 18%
1h30mnow
cpu%
ram (gib) 4.2G / 8.0G
1h30mnow
usedtotal
disk i/o (mb/s) 2.41 read · 0.32 write
1h30mnow
readwrite
network (mb/s) 5.82 in · 3.10 out
1h30mnow
inout
services: k3s-prod · server · 2026-05-04 13:02:11
←→ timeframe esc back open in proxmox ↗
Stages
Topology is the source of truth.
Describe, provision and install services.
step 01
describe
Describe clusters, nodes, VMs, images, sizes, stations, services and vaults.
topology.describe()
step 02
provision
DevStation generates and applies the OpenTofu configuration for you — no IaC to write. The plan stays visible and auditable, and it tracks real state.
provider.apply()
step 03
install
Register services in a station and use blueprints to install Docker, K3s, Portainer, Jenkins, ArgoCD and related tooling.
station.install()
↺ adjust topology · restart
Blueprints + stations
Blueprints define services; stations orchestrate.
A blueprint describes how to install and operate a service. A station registers services, resolves dependencies and secrets, and runs everything in the right order.
Blueprint catalog
Each blueprint lives in <name>/blueprint.yaml. Official ones ship in the binary; local ones live in ~/.devstation/blueprints and can override official blueprints.
Registered services
A service connects blueprint, vault, inputs and targets. State lives inside the station.
Orchestrated install
A station installs services in topological order; hosted services wait for their host to be ready.
catalog official blueprints: docker · k3s · argocd · portainer · jenkins · and more
extend devstation blueprint register — install your own; local overrides official
$ devstationblueprints/k3s/blueprint.yamlstation homelab-core -> services: k3s-prod, argocdNext step
continue with the docs.
At this alpha stage, the docs focus on the model, the Proxmox flow and the product's current limits.