Uma hospedagem compartilhada atende bem um site simples, mas rapidamente limita quem precisa publicar APIs, aplicações em Node.js, bancos de dados, automações ou projetos em containers. Saber como instalar Coolify em VPS permite transformar um servidor Linux em uma plataforma de deploy com controle sobre recursos, domínios, variáveis de ambiente e serviços.
O Coolify é uma alternativa autogerenciada a plataformas de deploy gerenciadas. Ele usa Docker para organizar aplicações e bancos de dados, oferece integração com repositórios Git e automatiza tarefas que, manualmente, exigiriam diversos comandos no terminal. Em troca dessa liberdade, a responsabilidade pelo servidor também é sua: atualizações, segurança, backups e uso de CPU, memória e disco precisam ser acompanhados.
Antes de instalar Coolify em uma VPS
O cenário mais indicado é uma VPS Linux nova, sem painéis de hospedagem, Docker pré-configurado ou aplicações utilizando as portas web. O Coolify precisa controlar componentes como containers, proxy reverso e certificados SSL. Instalá-lo em um servidor já usado por cPanel, aaPanel, EasyPanel ou outro painel pode gerar conflito de portas e serviços.
Para começar sem gargalos, use Ubuntu Server 22.04 LTS ou 24.04 LTS, arquitetura x86_64, acesso SSH como root ou usuário com permissões sudo e IP público fixo. Para testes pequenos, 2 vCPUs, 4 GB de RAM e 40 GB em SSD NVMe costumam ser suficientes. Para múltiplos aplicativos, banco de dados e builds frequentes, 4 vCPUs e 8 GB de RAM oferecem uma margem mais segura.
Também verifique se as portas 80 e 443 estão disponíveis para os sites publicados e se a porta 22 está liberada para SSH. O painel do Coolify utiliza uma porta própria durante a configuração inicial. Depois, o ideal é acessá-lo por um subdomínio protegido com HTTPS, em vez de manter a porta exposta para uso diário.
Antes de qualquer alteração, atualize o sistema:
```bash sudo apt update && sudo apt upgrade -y sudo reboot ```
Após reconectar por SSH, confirme a versão do Ubuntu e o espaço disponível:
```bash lsb_release -a df -h free -h ```
Esse cuidado evita instalar o painel em uma VPS com disco quase cheio ou com uma distribuição incompatível. Builds de aplicações podem consumir mais espaço do que o projeto final, principalmente quando há dependências pesadas ou imagens Docker antigas acumuladas.
Prepare a segurança básica da VPS
Uma VPS acessível pela internet recebe tentativas automáticas de acesso desde os primeiros minutos. Antes de publicar qualquer aplicativo, defina uma senha forte ou, preferencialmente, use autenticação por chave SSH. Desative o login direto por senha do root quando tiver certeza de que consegue entrar com uma chave configurada.
O firewall deve liberar apenas o necessário. Em uma instalação comum, mantenha SSH, HTTP e HTTPS disponíveis:
```bash sudo ufw allow OpenSSH sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw enable sudo ufw status ```
Se precisar acessar temporariamente a interface inicial pela porta informada pelo instalador, libere essa porta somente durante a configuração. Em seguida, use um domínio para o painel, configure SSL e remova a regra extra do firewall. Essa pequena medida reduz a exposição desnecessária.
Também vale criar um hostname fácil de identificar, especialmente se você administra mais de uma VPS:
```bash sudo hostnamectl set-hostname coolify-producao ```
Em serviços críticos, a proteção Anti-DDoS da infraestrutura ajuda a reduzir impactos de tráfego malicioso, mas não substitui práticas básicas como senhas fortes, atualizações e acesso SSH restrito.
Como instalar Coolify em VPS passo a passo
A instalação oficial do Coolify é feita por um script que prepara Docker, Docker Compose, serviços do painel e componentes necessários para o deploy. Como scripts de instalação podem mudar conforme novas versões são lançadas, obtenha sempre o comando atualizado na documentação oficial do projeto e execute-o apenas em uma VPS limpa e confiável.
O processo normalmente exige poucos minutos. Durante a execução, o instalador baixa imagens de container e configura os serviços. Não interrompa a sessão SSH e não reinicie a VPS antes da conclusão. Se estiver usando uma conexão instável, execute a instalação dentro de uma sessão `tmux` ou `screen`, evitando que o processo seja encerrado ao fechar o terminal.
Depois da instalação, confirme que os containers estão ativos:
```bash docker ps ```
Você deverá visualizar os serviços relacionados ao Coolify e ao proxy reverso. Caso algum container esteja reiniciando continuamente, consulte os logs antes de tentar reinstalar tudo:
```bash docker ps -a docker logs NOME_DO_CONTAINER --tail 100 ```
Reinstalar sem identificar a causa pode apagar configurações e não resolve problemas de RAM insuficiente, porta ocupada ou falha de rede. Em servidores menores, falta de memória é uma causa comum de builds interrompidos. Se a VPS tiver 2 GB de RAM, considere aumentar o plano ou criar swap com cautela. Swap evita algumas quedas, mas não entrega a mesma velocidade da memória RAM real.
Configure domínio, SSL e acesso ao painel
Com o painel funcionando, acesse a interface pelo IP e porta inicial informados ao final da instalação. Crie o usuário administrador e altere imediatamente qualquer credencial temporária. Em seguida, defina um subdomínio exclusivo para o painel, como `deploy.seudominio.com`.
No DNS do domínio, crie um registro A apontando esse subdomínio para o IP público da VPS. Aguarde a propagação e configure o domínio dentro do Coolify para emitir o certificado SSL. As portas 80 e 443 precisam estar abertas para que a validação automática funcione.
Para os aplicativos, o processo é semelhante: cada projeto pode usar um domínio próprio, como `app.seudominio.com` ou `api.seudominio.com`. O Coolify encaminha as requisições para o container correto e administra os certificados. Isso elimina a necessidade de configurar manualmente um proxy reverso para cada deploy, desde que não exista outro serviço disputando as portas web da VPS.
Evite usar o mesmo domínio para painel e aplicação. Separar os acessos simplifica a manutenção e reduz erros de roteamento. Se o projeto usar e-mails transacionais, configure também SPF, DKIM e registros adequados no DNS. SSL protege a comunicação web, mas não resolve a reputação de envio de e-mails.
Publique o primeiro aplicativo com controle
No painel, crie um novo projeto e adicione um recurso de aplicação. Você pode conectar um repositório Git, usar uma imagem Docker existente ou enviar uma configuração baseada em Docker Compose. Para a maioria dos projetos modernos, a conexão com Git facilita o fluxo: cada atualização enviada para a branch definida pode gerar um novo deploy.
Informe as variáveis de ambiente no painel, nunca no código ou em arquivos enviados ao repositório. Chaves de API, senhas de banco, tokens de pagamento e segredos de autenticação devem ficar fora do controle de versão. Quando alterar uma variável, faça um novo deploy para que o container receba a configuração atualizada.
Ao publicar um banco de dados, não exponha sua porta publicamente sem necessidade. Uma aplicação hospedada na mesma VPS consegue se comunicar pela rede interna dos containers. Abrir PostgreSQL, MySQL ou Redis para toda a internet aumenta a superfície de ataque e raramente é necessário para uma operação comum.
Antes de considerar o deploy finalizado, teste o domínio, os logs da aplicação e a persistência de dados. Um container pode estar online e ainda assim apresentar erro de conexão com banco, variável ausente ou falha no comando de inicialização. O log é a fonte mais direta para encontrar esses problemas.
Backups, atualizações e limites de recursos
O Coolify simplifica o deploy, mas não cria uma estratégia de continuidade automaticamente. Faça backup externo dos volumes persistentes e dos bancos de dados. Manter uma cópia no mesmo disco da VPS protege contra um erro de aplicação, mas não contra falha total do servidor ou exclusão acidental do volume.
Defina uma rotina de backup compatível com o valor do projeto. Um site institucional pode aceitar backup diário; uma plataforma com pedidos ou dados de clientes pode exigir cópias mais frequentes e testes regulares de restauração. Backup que nunca foi restaurado é apenas uma expectativa, não uma garantia.
Atualize o sistema operacional e o Coolify em janelas planejadas. Antes de atualizações maiores, registre a versão atual, confira espaço em disco e tenha um backup disponível. Acompanhe também o uso de recursos com comandos simples:
```bash htop docker stats df -h ```
Quando CPU, RAM ou disco ficam constantemente próximos do limite, o melhor ajuste não é apenas reiniciar containers. Pode ser hora de otimizar a aplicação, remover imagens sem uso ou migrar para uma VPS com mais recursos. Na HostMF, uma VPS Linux com SSD NVMe, tráfego ilimitado e ativação imediata oferece uma base prática para centralizar seus deploys com Coolify.
Comece com uma aplicação simples, documente cada variável e valide seus backups antes de levar sistemas essenciais para produção. Esse processo cria uma operação mais previsível e deixa sua VPS pronta para crescer junto com os projetos.
