Ajuda
Problemas comuns
Uma lista dos erros mais comuns durante conexão, provisionamento e deploy — os mesmos que o Assistente de IA já reconhece automaticamente.
Conexão e permissões
O usuário SSH cadastrado não tem permissão de administrador na VPS. Use um usuário com sudo habilitado (ou o próprio root) ao cadastrar o servidor — o painel eleva permissão automaticamente nos comandos que precisam.
Confirme que o IP e a porta SSH estão corretos e que a porta está liberada no firewall da VPS (grupos de segurança de provedores como AWS/Oracle costumam bloquear por padrão). Confirme também que a chave privada colada corresponde exatamente à chave pública autorizada no servidor.
Deploy
O Nixpacks detecta a linguagem por arquivos característicos na raiz do repositório (package.json, requirements.txt, go.mod, etc). Confirme que esses arquivos estão na raiz — ou adicione um Dockerfile próprio se a estrutura do projeto for atípica.
Verifique se a porta do container configurada no projeto é exatamente a porta que o processo escuta internamente, e se o DNS do domínio já propagou para o IP da VPS (nslookup seudominio.com).
Confirme se a variável de ambiente com a connection string está correta e se o valor foi salvo antes do deploy. Se app e banco estão na mesma VPS, prefira localhost em vez do IP externo — é mais rápido e evita bloqueios de rede desnecessários.
SSL
A causa mais comum é o domínio ainda não apontar para o IP da VPS, ou a propagação DNS não ter concluído. Confirme com nslookup e tente novamente após a propagação. Em ambientes sem domínio público, mantenha o toggle SSL desligado.
Nota
Nenhum desses cenários bate com o seu problema? O log completo do deploy (com a análise da IA, quando disponível) costuma apontar a causa exata — veja mais em
AI Debug Assistant.