[ cockpit open source / homelab & dev / multi-provider ]
Sua topologia, descrita uma vez. Reconstruída sempre que precisar.
DevStation é um cockpit open source para engenharia. Topologies, o primeiro recurso, modela, provisiona e recria ambientes de homelab e desenvolvimento — multi-provider por design, com Proxmox hoje.
$
Ver no GitHub curl -fsSL https://devstation.tech/install | sh devstation@homelab ~ $ devstation
sessão 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 ↗
Etapas
A topologia é a fonte de verdade.
Descreva, provisione e instale serviços.
step 01
describe
Descreva clusters, nodes, VMs, images, sizes, stations, services e vaults.
topology.describe()
step 02
provision
O DevStation aplica a topologia, cria as VMs no provider escolhido e acompanha o estado real.
provider.apply()
step 03
install
Registre services em uma station e use blueprints para instalar Docker, K3s, Portainer, Jenkins, ArgoCD e afins.
station.install()
↺ ajuste a topologia · recomece
Blueprints + stations
Receitas declarativas para começar, stations para orquestrar.
Blueprints são receitas YAML para instalar e operar serviços em instâncias. Services são usos dessas receitas dentro de uma station, que ordena dependências, resolve secrets no vault e executa a instalação.
Catálogo de blueprints
Blueprints vivem em <nome>/blueprint.yaml. Podem ser standalone, com instâncias próprias, ou hosted sobre outro service. Os oficiais vêm com o DevStation; os seus ficam em ~/.devstation/blueprints.
Services como instâncias
Ao registrar um service, você escolhe blueprint, vault, inputs e VMs ou host. O estado fica dentro da station.
Instalação orquestrada
Stations instalam um subconjunto de services em ordem topológica; services hosted esperam o host estar pronto.
catalog blueprints oficiais: docker · k3s · argocd · portainer · jenkins · e mais
extend devstation blueprint register — instale os seus; o local sobrescreve o oficial
$ devstationblueprints/k3s/blueprint.yamlstation homelab-core -> services: k3s-prod, argocdPróximo passo
continue pela documentação.
A CLI está em pre-alpha. Em vez de esconder isso atrás de comandos prematuros, o melhor caminho é entender o modelo e o provider atual.