[ 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://devstation.tech/install | 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 applies the topology, creates VMs on your chosen provider and 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
Declarative recipes to start, stations to orchestrate.
Blueprints are YAML recipes for installing and operating services on instances. Services are uses of those recipes inside a station, which orders dependencies, resolves vault secrets and runs installs.
Blueprint catalog
Blueprints live in <name>/blueprint.yaml. They can be standalone, with their own instances, or hosted on another service. Official ones ship with DevStation; yours live in ~/.devstation/blueprints.
Services as instances
When you register a service, you choose blueprint, vault, inputs and VMs or host. The state lives inside the station.
Orchestrated install
Stations install a selected subset of 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.
The CLI is still pre-alpha. Instead of hiding that behind premature commands, the best path is to understand the model and the current provider.