Coolify (PaaS Auto-hospedado)

1. Visão geral do conceito e problema sistêmico

As plataformas PaaS em nuvem (Vercel, Heroku, Netlify, Render) ofereceram aos desenvolvedores um nível incomparável de conforto: um simples git push compila automaticamente o projeto, aloca um domínio, configura SSL e faz o deploy do serviço. No entanto, por esse conforto, as empresas pagam com escravidão financeira e restrições arquitetônicas rígidas:

• Billing predatório: O custo de tráfego nas nuvens é 10 a 20 vezes superior ao preço de mercado, e faturas por exceder limites podem chegar a milhares de dólares.
• Timeouts serverless: O limite de execução de funções (15–60 segundos) torna impossível executar ciclos agentic autônomos, scraping complexo ou raciocínios prolongados de modelos de linguagem.
• Vendor lock-in: Otimizações específicas dificultam a migração do código para hardware próprio.

O Coolify oferece o melhor dos dois mundos: uma experiência Vercel em seu próprio servidor por $5 a $20 mensais. Trata-se de um sistema aberto de gerenciamento de servidores (Self-Hosted PaaS), que se instala com um único comando, conecta-se a repositórios GitHub/GitLab e assume todo o ciclo de build, roteamento de tráfego e administração de bancos de dados.

2. Taxonomia arquitetural e modelo mental

A estrutura arquitetural do Coolify baseia-se na orquestração do daemon Docker e em um proxy dinâmico:

┌─────────────────────────────────────────────────────────────┐
│                    ARQUITETURA DO HOST COOLIFY              │
├─────────────────────────────────────────────────────────────┤
│ 1. Proxy Reverso Dinâmico (Traefik v3 Core Engine)          │
│    • Roteamento automático de portas via Docker Labels      │
│    • Certificados SSL automáticos Let's Encrypt (ACME)      │
├─────────────────────────────────────────────────────────────┤
│ 2. Plano de Controle Coolify (API Laravel & UI Web ao Vivo) │
│    • Gerenciador de webhooks GitHub / GitLab                │
│    • Gestão de variáveis de ambiente (.env encryption)      │
├─────────────────────────────────────────────────────────────┤
│ 3. Motor de Build Poliglota:                                │
│    • Nixpacks (Detecção automática de linguagens: Node,     │
│      Bun, Python, Go)                                       │
│    • Construtor Dockerfile / Docker Compose                 │
├─────────────────────────────────────────────────────────────┤
│ 4. Datastores e Armazenamento Gerenciados                   │
│    (Postgres, Redis, Backup S3)                             │
└─────────────────────────────────────────────────────────────┘

1. Proxy reverso dinâmico (Traefik Engine):
   • Dispatcher central do tráfego de entrada. Ele escuta continuamente o socket do Docker: quando um novo container sobe com tags de domínio, o Traefik captura-o instantaneamente, emite um certificado SSL e começa a direcionar requisições HTTP/HTTPS sem reiniciar o proxy.
2. Motor universal de build (Nixpacks & Docker):
   • Garante a compilação do código sem a necessidade de escrever manualmente Dockerfile complexos. O Nixpacks detecta automaticamente a versão do Node.js, instala dependências via pnpm e gera um container mínimo.
3. Gerenciamento de dados em um clique (Managed Databases):
   • Deploy de instâncias de produção PostgreSQL, Redis, MySQL, ClickHouse ou MinIO com backup criptografado automático para armazenamento S3 em nuvem (AWS ou Cloudflare R2) conforme cronograma.
4. Isolamento de ambientes (Preview Deployments):
   • Subida automática de cópias efêmeras isoladas do serviço para cada Pull Request aberto em subdomínios temporários.

3. Pipeline técnico e mecânica interna

O ciclo de vida do deploy contínuo (GitOps Lifecycle) no Coolify:

1. Fixação do código e webhook: O engenheiro executa git push origin main. O GitHub envia um webhook HMAC assinado para a API do Coolify.
2. Validação e início do worker: O Coolify verifica a assinatura de segurança, baixa o commit fresco pelo hash SHA especificado e inicia um container de build isolado.
3. Fase de compilação (Nixpacks Build): As dependências são instaladas e a build da aplicação é executada (npm run build). Uma imagem Docker otimizada de runtime é criada.
4. Troca suave de tráfego (Rolling Deployment):
   • Um novo container da aplicação sobe em uma nova porta interna.
   • O Traefik verifica o estado de saúde (Health Check).
   • Assim que o novo container responde com HTTP 200, o proxy redireciona o tráfego e o container antigo é parado (Zero-Downtime Swap).
5. Alertas e notificações: O status do deploy bem-sucedido é enviado ao engenheiro via Telegram ou Discord com link para o commit.

4. Cenários práticos de engenharia em produção

01. Deploy de plataforma Next.js 15 Full-Stack em servidor de $10

Lançamento completo de um SaaS comercial em VPS na Hetzner:

• O Coolify compila o frontend Next.js, sobe o banco PostgreSQL e o Redis para cache de sessões.
• O tráfego passa pelo Traefik embutido com suporte a HTTP/2 e SSL.
• O serviço suporta milhões de visualizações mensais com zero custos adicionais de nuvem.

02. Hospedagem de agentes AI de longa duração sem timeouts

Deploy de processos backend complexos (LangGraph, autoscraper):

• Na Vercel, a requisição é abortada após 60 segundos.
• No Coolify, o agente pode operar autonomamente por 4 horas consecutivas em um container em background, mantendo conexões WebSockets abertas com o cliente.

03. Criação de ambientes de preview temporários (PR Previews)

Organização de code review confortável para a equipe:

• Ao abrir o PR #87, o Coolify sobe automaticamente a aplicação no endereço pr-87.gotburnout.dev.
• O tester valida a funcionalidade ao vivo antes do merge na branch principal; após isso, o container é excluído automaticamente ao fechar o PR.

5. Armadilhas, erros comuns e segurança

• Queda do servidor por estouro de memória (Build OOM): A compilação de projetos frontend modernos em Next.js pode consumir até 3–4 GB de RAM durante a otimização dos bundles. Em servidores com 2 GB de RAM, é obrigatório criar um arquivo de swap (swapfile) de no mínimo 4 GB.
• Deixar o painel de controle exposto a scanners: Por padrão, a interface do Coolify opera na porta 8000. Proteja-a obrigatoriamente com um domínio próprio e autenticação de dois fatores (2FA) forçada, ou bloqueie via firewall UFW, permitindo tráfego apenas através de Tailscale/VPN.
• Estouro de disco por imagens Docker antigas: Deploys diários geram dezenas de camadas compiladas. Se não habilitar a limpeza automática (Docker Cleanup Scheduler), o disco ficará cheio em poucas semanas.
• Armazenamento de senhas de banco de dados em arquivos inseguros: Utilize o gerenciador de secrets embutido do Coolify para injetar variáveis de ambiente, em vez de fazer commit de arquivos .env no repositório.