●status:pre-alpha
version:v0.1.0-pre
lang: EN PT ES
[ topology-first / open source / multi-provider ]

Sua topologia,
descrita uma vez.
Reconstruída sempre
que precisar.

DevStation é o cockpit open source para criar, preparar e recriar ambientes de homelab e desenvolvimento a partir de uma topologia clara. Multi-provider por design, com suporte hoje a Proxmox.

$ curl -fsSL devstation.tech/install | sh
Ver no GitHub↗
devstation@homelab ~ $ devstation
sessão 04:12
Etapas

A topologia é a fonte de verdade.
Modele, provisione, faça deploy.

step 01
model
Descreva clusters, nodes, máquinas, templates, definitions, environments e roles.
topology.declare()
step 02
provision
O DevStation aplica a topologia e cria as VMs no provider escolhido.
provider.apply()
step 03
deploy
Deploy transforma VMs em hosts úteis com Docker, K3s, Portainer ou Jenkins.
stack.deploy()
↺ ajuste a topologia · recomece
Filosofia

Princípios que orientam o que entra e o que fica de fora.

01
Topology-first
A topologia vem antes do provider, da interface e de qualquer ferramenta sob o capô.
02
Multi-provider por design
A mesma topologia deve rodar contra o provider escolhido. Proxmox hoje; outros entram pelo mesmo modelo.
03
Provisionamento legível, não caixa-preta
Você não precisa conhecer cada ferramenta possível para começar. Planos, decisões e passos continuam visíveis.
04
Automação com controle
Nada é mágica. O CLI é opinativo; o usuário continua dono da infraestrutura.
05
Aberto desde a fundação
Open source não é uma decisão futura. É a base do produto.
06
Comece simples, cresça flexível
A primeira topologia cabe em poucos minutos. A décima segue o mesmo modelo.
Community stacks

Stacks first-party para começar, os seus para crescer.

O DevStation não precisa ser um catálogo fechado. A CLI carrega stacks TypeScript do seu próprio diretório, então a comunidade pode versionar, adaptar e compartilhar automações sem depender de registry central.

Catálogo local
Stacks vivem em stacks/<nome>/stack.ts e podem ser apontados por STACKS_PATH. Seu catálogo pode ficar no seu repo.
Automação auditável
Cada stack declara SO suportado, inputs, steps, verify e secrets publicados. Você lê o que roda antes de aplicar.
Sem lock-in de plataforma
First-party stacks aceleram o começo; community stacks deixam cada homelab seguir seu próprio padrão.
catalog first-party: docker · k3s · argocd · portainer · infisical
path community-ready: fork · adapte · publique seu catálogo
$ STACKS_PATH=./stacks devstation
stacks/my-stack/stack.ts
export default stack({ name, supportedOs, inputs, steps })
Roadmap

Sóbrio sobre o presente, claro sobre o futuro.

Agora pronto
▣ Modelagem de topologia via TUI
▣ Vault local cifrado
▣ Status ao vivo do Proxmox
▣ Provisionamento inicial no Proxmox
▣ TUI em React Ink
Próximo próximo
▢ Portabilidade macOS e Windows
▢ Deploy de serviços
▢ Services, stacks e DeployRun
▢ Core RPC para múltiplas UIs
Horizonte depois
· Novos providers
· Catálogo da comunidade
· Times pequenos e laboratórios internos
· Registry, marketplace ou SaaS opcional
Quick start

pronto para começar?

Instale a CLI, abra a TUI e descreva sua primeira topologia. O repositório continua disponível para quem quiser auditar ou contribuir.

$ curl -fsSL devstation.tech/install | sh 01 / 03
$ devstation 02 / 03
$ model topology → provision → deploy 03 / 03