iniciantefundamentos

Setup Inicial do Coolify

Instale o Coolify no seu servidor em menos de 5 minutos com um único comando. Guia passo a passo completo.

Por Fabricio Telles

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:

  1. ✅ Verificar requisitos do sistema
  2. ✅ Instalar Docker se necessário
  3. ✅ Baixar e configurar Coolify
  4. ✅ 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:

  1. Criar sua conta de administrador
  2. Configurar o servidor como “localhost”
  3. 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

  1. Vá em SettingsConfiguration
  2. Em Instance’s Domain, coloque: https://coolify.seudominio.com
  3. Clique Save
  4. 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:

  • coolify
  • coolify-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

  1. Verifique se o DNS propagou: dig coolify.seudominio.com
  2. Portas 80 e 443 devem estar abertas
  3. 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:

  1. Deploy sua primeira app — Conecte GitHub e faça deploy
  2. Configurar Banco de Dados — PostgreSQL, MySQL ou MongoDB
  3. Backups Automáticos — Proteja seus dados

Importante: Nunca exponha a porta 8000 em produção. Configure um domínio com SSL o quanto antes.