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.

cerca de 15 minjunho/2026 · Ubuntu 24.04 LTS

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

    Atualizar o sistema

    Atualize os pacotes antes de executar o instalador.

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

    bash
    curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash
  3. 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. 4

    Configurar firewall UFW

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

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

  6. 6

    Configurar o servidor raiz no Coolify

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

  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.

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.

bash
ufw status | grep 8000
docker ps | grep coolify

O Coolify usa a chave SSH do usuário root para conectar ao servidor. Verifique se a chave pública está em ~/.ssh/authorized_keys.

bash
cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

Certifique-se de que o Docker está rodando e que o usuário tem permissão para usá-lo.

bash
systemctl status docker
docker ps

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

bash
# Verifique em: coolify.io/docs/installation

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