Como instalar o Coolify em uma VPS Ubuntu
O Coolify é uma plataforma open-source self-hosted para deploy de aplicações, bancos de dados e serviços, uma alternativa ao Heroku e Render. A instalação é feita via script oficial que configura Docker e todos os componentes automaticamente.
Antes de começar
- VPS mínima
- 2 vCPU · 2 GB RAM · 30 GB SSD (Runstack Basic ou superior)
- Sistema
- Ubuntu 24.04 LTS
- Também
- Acesso root ao servidor
- Porta 8000 acessível no firewall (painel web)
- Portas 80 e 443 abertas para apps deployados
- SSH na porta 22 (o Coolify usa SSH para gerenciar servidores remotos)
Instalação passo a passo
- 1
Atualizar o sistema
Atualize os pacotes antes de executar o instalador.
bashapt update && apt upgrade -y - 2
Executar o instalador oficial do Coolify
O Coolify fornece um script de instalação que instala Docker, configura os containers do Coolify e inicia todos os serviços automaticamente.
bashcurl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash - 3
Verificar a instalação
Confirme que os containers do Coolify estão rodando após a instalação.
bash# Verificar containers do Coolify docker ps | grep coolify # Verificar serviço (se configurado como systemd) systemctl status coolify 2>/dev/null || echo "Gerenciado diretamente pelo Docker" - 4
Configurar firewall UFW
Libere as portas necessárias para o painel e para os apps que serão deployados.
bashufw allow 22/tcp comment 'SSH' ufw allow 80/tcp comment 'HTTP (apps deployados)' ufw allow 443/tcp comment 'HTTPS (apps deployados)' ufw allow 8000/tcp comment 'Coolify painel web' ufw --force enable ufw status verbose - 5
Acessar o painel e criar conta de administrador
Acesse o Coolify pelo navegador e configure a conta de administrador.
- 6
Configurar o servidor raiz no Coolify
Após fazer login, registre o próprio servidor como destino de deploy.
- 7
Configurar domínio para o painel (opcional mas recomendado)
Para acesso HTTPS ao painel, configure um domínio nas configurações do Coolify. Ele gerencia o certificado SSL automaticamente via Let's Encrypt.
Não quer configurar manualmente?
Implante o Coolify em menos de 5 minutos com a Runstack. Infraestrutura da OPEN Datacenter, com servidores em São Paulo.
Se der problema
Verifique se o UFW está liberando a porta 8000 e se os containers do Coolify estão rodando.
ufw status | grep 8000
docker ps | grep coolifyO Coolify usa a chave SSH do usuário root para conectar ao servidor. Verifique se a chave pública está em ~/.ssh/authorized_keys.
cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keysCertifique-se de que o Docker está rodando e que o usuário tem permissão para usá-lo.
systemctl status docker
docker psVerifique se o domínio do app resolve para o IP do servidor e se as portas 80 e 443 estão abertas no firewall. O Let's Encrypt precisa dessas portas para validação.
Verifique a versão mais recente do script de instalação na documentação oficial do Coolify. A URL do script pode ter mudado.
# Verifique em: coolify.io/docs/installationPerguntas frequentes
O Coolify é focado em deploy de aplicações modernas (Docker, Git-based deploys) e não é um painel de hospedagem tradicional. Para PHP/WordPress/email hosting, painéis como HestiaCP são mais adequados.
Sim. O Coolify suporta deploy de apps Node.js, Next.js, PHP, Python, Ruby, Go e qualquer aplicação com Dockerfile ou Nixpacks. Também suporta deploy direto de repositórios GitHub/GitLab.
A versão self-hosted é gratuita e open-source. Existe um plano cloud gerenciado pago em coolify.io, mas para VPS própria não há custo de licença.
O Coolify tem atualização automática configurável. Também é possível atualizar manualmente pelo painel em Settings → Update.
Sim. O Coolify suporta gerenciamento de múltiplos servidores remotos a partir de um único painel. Adicione servidores em Settings → Servers.