Conceitos principais
Todo o painel gira em torno de quatro conceitos. Entender esse vocabulário torna o resto da documentação muito mais direto.
Servidor (VPS)
É a sua máquina Linux — cadastrada uma vez com IP, usuário SSH e chave privada. Um servidor pode hospedar quantos projetos e bancos de dados a capacidade dele aguentar. Provisionar um servidor instala as ferramentas de base (Docker, Nixpacks, proxy reverso) uma única vez.
Projeto
A unidade de deploy. Um projeto liga um repositório Git a um servidor, um domínio e um modo de build. É nele que você configura variáveis de ambiente, acompanha deploys e vê logs.
Deploy
Cada execução do pipeline de publicação — clonar/atualizar o código, buildar a imagem, subir o container e atualizar o roteamento. Todo deploy fica registrado com log completo, então você sempre pode olhar o histórico ou reverter para uma versão anterior.
Variáveis de ambiente
Configurações sensíveis do seu app — credenciais, URLs de banco, chaves de API — que não vivem no código-fonte. Ficam criptografadas no painel e são aplicadas ao container automaticamente a cada deploy.
Banco de dados
Uma instância de banco (PostgreSQL, MySQL, MariaDB, MongoDB ou Redis) instalada diretamente na sua VPS pelo painel, com usuário, senha e connection string próprios. O banco pertence ao servidor — e pode, opcionalmente, ser vinculado a um projeto pra facilitar a organização.
| Conceito | Cardinalidade | Onde vive |
|---|---|---|
| Servidor | 1 conta → N servidores | Sua infraestrutura |
| Projeto | 1 servidor → N projetos | Container Docker no servidor |
| Deploy | 1 projeto → N deploys (histórico) | Registro no painel + imagem no servidor |
| Banco de dados | 1 servidor → N bancos | Serviço nativo no servidor |