Comece aqui

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.

ConceitoCardinalidadeOnde vive
Servidor1 conta → N servidoresSua infraestrutura
Projeto1 servidor → N projetosContainer Docker no servidor
Deploy1 projeto → N deploys (histórico)Registro no painel + imagem no servidor
Banco de dados1 servidor → N bancosServiço nativo no servidor