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.

Instalação passo a passo

1. 1

   Atualizar o sistema

   Atualize os pacotes antes de executar o instalador.

   bashCopiar

   apt update && apt upgrade -y

2. 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.

   bashCopiar

   curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

   Dica

   A instalação leva 2-5 minutos. O script instala Docker caso não esteja presente e configura o Coolify como conjunto de containers gerenciados.

   Atenção

   Confirme a URL do script de instalação em coolify.io/docs antes de executar — ela pode mudar entre versões. Nunca execute scripts de URLs não verificadas em produção.
3. 3

   Verificar a instalação

   Confirme que os containers do Coolify estão rodando após a instalação.

   bashCopiar

   # 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. 4

   Configurar firewall UFW

   Libere as portas necessárias para o painel e para os apps que serão deployados.

   bashCopiar

   ufw 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. 5

   Acessar o painel e criar conta de administrador

   Acesse o Coolify pelo navegador e configure a conta de administrador.

   Dica

   Acesse http://IP-DA-VPS:8000 no navegador. O Coolify solicita a criação do usuário administrador no primeiro acesso. Após criar a conta, configure um domínio com HTTPS para o painel nas configurações.
6. 6

   Configurar o servidor raiz no Coolify

   Após fazer login, registre o próprio servidor como destino de deploy.

   Dica

   Em Settings → Servers → Add Server, adicione o servidor local usando o endereço 127.0.0.1 com a chave SSH configurada. O Coolify usa SSH mesmo para o servidor local.
7. 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.

   Dica

   Em Settings → Instance Settings, configure o Wildcard Domain e o e-mail para Let's Encrypt. O Coolify emite e renova os certificados automaticamente para os apps deployados.

Troubleshooting

Perguntas frequentes