Setup Inicial do Coolify
Instale o Coolify no seu servidor em menos de 5 minutos com um único comando. Guia passo a passo completo.
Pré-requisitos
Antes de começar, você precisa de:
- Servidor Linux com Ubuntu 22.04+ ou Debian 12+
- Acesso root via SSH
- 2 GB RAM mínimo (4 GB recomendado)
- Portas abertas: 22 (SSH), 80 (HTTP), 443 (HTTPS)
Não tem servidor? Recomendo Hetzner (a partir de €3,79/mês) ou Oracle Cloud (free tier generoso com ARM).
Passo 1: Conecte ao Servidor
ssh root@seu-servidor-ip
Se usar chave SSH (recomendado):
ssh -i ~/.ssh/sua-chave root@seu-servidor-ip
Passo 2: Instale o Coolify
Execute o script de instalação oficial:
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash
O script vai:
- ✅ Verificar requisitos do sistema
- ✅ Instalar Docker se necessário
- ✅ Baixar e configurar Coolify
- ✅ Iniciar os containers
Tempo estimado: 2-5 minutos dependendo da conexão.
Passo 3: Acesse o Painel
Após a instalação, acesse:
http://seu-servidor-ip:8000
Na primeira vez, você vai:
- Criar sua conta de administrador
- Configurar o servidor como “localhost”
- Pronto! 🎉
Passo 4: Configure um Domínio (Opcional)
Para acessar via domínio em vez de IP:
4.1 Aponte o DNS
No seu provedor de DNS (Cloudflare, Route53, etc.):
Tipo: A
Nome: coolify (ou @ para raiz)
Valor: seu-servidor-ip
TTL: Auto
4.2 Configure no Coolify
- Vá em Settings → Configuration
- Em Instance’s Domain, coloque:
https://coolify.seudominio.com - Clique Save
- O SSL será configurado automaticamente
Portas Necessárias
Certifique-se que estas portas estão abertas no firewall:
| Porta | Protocolo | Uso |
|---|---|---|
| 22 | TCP | SSH |
| 80 | TCP | HTTP (redirect para HTTPS) |
| 443 | TCP | HTTPS |
| 8000 | TCP | Painel Coolify (antes de configurar domínio) |
Comandos úteis para firewall
UFW (Ubuntu):
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable
firewalld (CentOS/Fedora):
firewall-cmd --permanent --add-port=22/tcp
firewall-cmd --permanent --add-port=80/tcp
firewall-cmd --permanent --add-port=443/tcp
firewall-cmd --reload
Verificando a Instalação
Para confirmar que tudo está rodando:
docker ps
Você deve ver containers como:
coolifycoolify-proxy(Traefik)coolify-db(PostgreSQL)coolify-redis
Troubleshooting
Erro: “Cannot connect to Docker daemon”
systemctl start docker
systemctl enable docker
Porta 8000 não responde
Verifique se o container está rodando:
docker logs coolify
SSL não funciona
- Verifique se o DNS propagou:
dig coolify.seudominio.com - Portas 80 e 443 devem estar abertas
- Aguarde alguns minutos — Let’s Encrypt pode demorar
Atualizando o Coolify
O Coolify atualiza automaticamente por padrão. Para forçar atualização:
cd /data/coolify/source
docker compose pull
docker compose up -d
Próximos Passos
Agora que o Coolify está instalado:
- Deploy sua primeira app — Conecte GitHub e faça deploy
- Configurar Banco de Dados — PostgreSQL, MySQL ou MongoDB
- Backups Automáticos — Proteja seus dados
Importante: Nunca exponha a porta 8000 em produção. Configure um domínio com SSL o quanto antes.
Coolify.io