DEV Community

Fernando Chagas for Nuvits

Posted on Originally published at nuvits.net

Como instalar o Coolify numa VPS Ubuntu

Este guia instala o Coolify numa VPS Ubuntu 24.04 limpa, com o script oficial, e deixa o painel no ar na porta 8000. No fim, o firewall passa a valer para as portas que o Docker publica, e dá para ver o que o proxy responde em 80 e 443 antes de existir um domínio.

O teste foi feito em 18/11/2026 numa máquina virtual Ubuntu 24.04.5 LTS de 64 bits, com 2 vCPU, 2,9 GiB de RAM e disco de 40 GB, sem Docker nem painel prévios. O instalador terminou em 1 min 27 s. Não havia um domínio público apontando para essa máquina, então o certificado de produção não foi emitido: a seção de domínio diz exatamente até onde a verificação chegou.

O que você vai precisar

  • Uma VPS com Ubuntu 24.04 LTS de 64 bits e acesso SSH. O instalador roda como root.
  • O mínimo que a documentação de instalação pede hoje: 2 núcleos de CPU, 2 GB de RAM e 10 GB livres de disco, em amd64 ou arm64. A mesma página recomenda um servidor novo, para não misturar o painel com outro Docker já em uso.
  • Um domínio só quando você for servir o painel ou uma aplicação por HTTPS. Dá para criar a conta e usar o painel pelo IPv4 antes disso.

A máquina deste teste ficou folgada para o painel sozinho: depois da instalação o disco tinha 4,5 GB usados e 34 GB livres. Uma aplicação publicada ao lado do Coolify precisa de memória e disco além desse piso. O cartão ao lado do artigo aponta um plano acima do mínimo.

Se o plano oferecer o aplicativo pré-instalado, dá para pedir o Coolify na contratação. O caminho abaixo é o script oficial, numa Ubuntu que chega só com o sistema.

Quem chegar primeiro vira administrador. A documentação avisa que a primeira conta tem acesso total à instância, inclusive ao servidor. Crie essa conta assim que o instalador terminar. A janela fica aberta por 10 minutos.

Rodar o instalador oficial

Entre como root, ou use sudo. O comando é o da documentação:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash
Enter fullscreen mode Exit fullscreen mode

O script instala o que faltar de curl, wget, git, jq e openssl, confere o OpenSSH, instala o Docker Engine quando o sistema ainda não tem, grava a configuração do daemon, baixa os arquivos do Coolify e sobe os contêineres. Nesta imagem os pacotes do primeiro passo já existiam, e o passo terminou na hora. O OpenSSH já estava instalado, com PermitRootLogin without-password na porta 22, e o script registrou que o login de root por chave estava permitido.

O log da instalação guardou o que foi escolhido no canal stable:

| Operating System  | ubuntu 24.04
| Docker            | latest
| Coolify           | 4.7.5
| Helper            | 1.0.19
Enter fullscreen mode Exit fullscreen mode

No terminal, o fim foi este:

Coolify is ready!  Installed in 1m 27s
Enter fullscreen mode Exit fullscreen mode

Ele também imprime um ou mais endereços com a porta 8000. Use o IPv4 público da VPS, no formato http://IP_DA_VPS:8000.

A documentação pede para remover o Docker instalado por snap antes de rodar o script, se for o caso. O instalador recusa esse pacote. Nesta máquina o Docker não estava instalado, e o script usou o instalador do Docker Engine. A versão que ficou foi a 29.10.0, com o Compose v5.8.0:

Docker Compose version v5.8.0
Enter fullscreen mode Exit fullscreen mode

O daemon ficou com rotação de log e uma faixa de endereços para as redes do Docker. O arquivo gravado foi este:

{
  "default-address-pools": [
    {
      "base": "10.0.0.0/8",
      "size": 24
    }
  ],
  "log-driver": "json-file",
  "log-opts": {
    "max-file": "3",
    "max-size": "10m"
  }
}
Enter fullscreen mode Exit fullscreen mode

Criar a conta root

Abra http://IP_DA_VPS:8000 no navegador. Sem nenhuma conta, o painel sai de /login e abre o formulário de registro. Nesta instalação, GET / respondeu 302 para /login, e /login chegou em /register com 200. O título da página é Coolify, e o texto pede a conta root da instância: nome, e-mail, senha e a senha de novo. A própria página exige pelo menos 8 caracteres, com maiúscula, minúscula, número e símbolo.

Enviei esse formulário dentro da janela de 10 minutos. A resposta foi 302 para /settings, e /settings em seguida foi para /onboarding, com o título "Onboarding | Coolify". O onboarding oferece conectar o servidor ou pular. O instalador já tinha deixado um servidor local e o proxy em execução; o clique do onboarding não foi necessário para o painel responder.

Se a página disser que a janela fechou, o instalador manda reiniciar o contêiner e tentar de novo:

sudo docker restart coolify
Enter fullscreen mode Exit fullscreen mode

O que ficou no ar

Logo depois do instalador, sudo docker ps mostrou estes contêineres saudáveis. Os tempos de "Up" são os daquele minuto:

NAMES                       IMAGE                       STATUS                        PORTS
coolify-proxy-error-pages   busybox:musl                Up 16 seconds
coolify-proxy               traefik:v3.7                Up 22 seconds (healthy)       0.0.0.0:80->80/tcp, [::]:80->80/tcp, 0.0.0.0:443->443/tcp, [::]:443->443/tcp, 0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp, 0.0.0.0:443->443/udp, [::]:443->443/udp
coolify-sentinel            coollabsio/sentinel:1.1.5   Up 23 seconds (healthy)
coolify                     coollabsio/coolify:4.7.5    Up 57 seconds (healthy)       8000/tcp, 8443/tcp, 0.0.0.0:6001-6002->6001-6002/tcp, [::]:6001-6002->6001-6002/tcp, 9000/tcp, 0.0.0.0:8000->8080/tcp, [::]:8000->8080/tcp
coolify-db                  postgres:15-alpine          Up About a minute (healthy)   5432/tcp
coolify-redis               redis:7-alpine              Up About a minute (healthy)   6379/tcp
Enter fullscreen mode Exit fullscreen mode

O que isso significa na prática:

  • O painel é coollabsio/coolify:4.7.5. A porta 8000 do servidor é a porta 8080 do contêiner. As portas 6001 e 6002 também ficam publicadas.
  • O proxy é traefik:v3.7, nas portas 80 e 443. Ele também publica 8080 e 443/udp.
  • O Postgres 15 e o Redis 7 não publicam porta no host. A coluna PORTS só mostra a porta interna.
  • A imagem coollabsio/coolify-helper:1.0.19 foi baixada e não ficou como contêiner permanente.
  • O servidor local que o instalador registrou se chama localhost, aponta para host.docker.internal na porta 22, com o usuário root. O proxy desse servidor ficou como Traefik em execução.

Confira no seu servidor com:

sudo docker ps
sudo docker compose version
Enter fullscreen mode Exit fullscreen mode

Firewall

O Docker publica porta por conta própria, e o ufw não bloqueia esse tráfego. A documentação do Docker descreve o desvio, e a página de firewall do Coolify diz para não confiar no ufw sozinho. O teste com o Apache, o timeout e a regra que realmente fecha a porta estão no guia A porta do Docker continua aberta com o ufw.

Nesta máquina o ufw 0.36.2 foi configurado depois do Coolify, que é a ordem que deixa o Docker já no ar para o ufw-docker enxergar a cadeia DOCKER-USER. A cópia testada do ufw-docker é o commit 020a8699f95592561f254d8d4ad1bb40d401dfc7 (18/05/2026 no repositório, conferido de novo em 18/11/2026). O SHA-256 do arquivo baixado foi 643e56b080567c567b4aa28650196849b2a2da5dd0473fd3e5216b0886035ab0.

sudo apt update
sudo apt install ufw
sudo ufw allow 22/tcp
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw --force enable

sudo curl -fsSL -o /usr/local/bin/ufw-docker \
  https://raw.githubusercontent.com/chaifeng/ufw-docker/020a8699f95592561f254d8d4ad1bb40d401dfc7/ufw-docker
sudo chmod 755 /usr/local/bin/ufw-docker
sha256sum /usr/local/bin/ufw-docker
sudo ufw-docker install
sudo ufw reload
Enter fullscreen mode Exit fullscreen mode

O ufw allow 22/tcp vem antes do ufw enable para não derrubar o SSH. O ufw-docker install altera /etc/ufw/after.rules e /etc/ufw/after6.rules, grava uma cópia de cada um e pede sudo systemctl restart ufw. Rodei sudo ufw reload, e o bloqueio já passou a valer.

A regra do ufw-docker olha a porta do contêiner, não a porta do host. Por isso a porta 8000 do painel, que é a 8080 do contêiner, não abre com ufw route allow na 8000. As regras abaixo são as que testei. O 22 continua no ufw allow, porque o SSH não é porta de contêiner.

sudo ufw route allow proto tcp from any to any port 80
sudo ufw route allow proto tcp from any to any port 443
sudo ufw route allow proto tcp from any to any port 8080
sudo ufw route allow proto tcp from any to any port 6001
sudo ufw route allow proto tcp from any to any port 6002
sudo ufw status numbered
Enter fullscreen mode Exit fullscreen mode

O pedido de teste saiu de um namespace de rede com o endereço 203.0.113.10, de fora das faixas privadas que o ufw-docker deixa passar. Antes das regras route, o painel na porta 8000 e o proxy na 443 estouravam o tempo. Depois:

  • http://203.0.113.1:8000/ respondeu HTTP/1.1 302 Found para /login.
  • http://203.0.113.1/ respondeu HTTP/1.1 503 Service Unavailable.
  • https://203.0.113.1/ respondeu HTTP/2 503.
  • http://203.0.113.1:6001/ e http://203.0.113.1:6002/ responderam HTTP/1.1 404 Not Found. O 404 mostra que a porta aceita conexão. Não é uma página do painel.

O 503 nas portas 80 e 443 é o proxy sem nenhum domínio configurado. A porta 8080 que o Traefik também publica recusou a conexão nesse teste (curl: (7) Failed to connect), ao contrário da 8000.

Se a VPS tiver firewall no painel do provedor, a documentação do Coolify manda usar esse firewall e liberar só o que a instância usa: 22/tcp, 80/tcp, 443/tcp e, enquanto o painel não estiver num domínio, 8000/tcp, 6001/tcp e 6002/tcp. Esse firewall corta o pacote antes do servidor. O ufw sozinho não faz isso.

Domínio e HTTPS

Sem domínio, o proxy escuta 443 com o certificado padrão do Traefik. Conferi a partir do próprio servidor:

echo | openssl s_client -connect 127.0.0.1:443 -servername coolify.example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
Enter fullscreen mode Exit fullscreen mode
subject=CN = TRAEFIK DEFAULT CERT
issuer=CN = TRAEFIK DEFAULT CERT
notBefore=Nov 18 10:11:11 2026 GMT
notAfter=Nov 18 10:11:11 2027 GMT
Enter fullscreen mode Exit fullscreen mode

Não use esse certificado para o painel. A documentação de DNS e a de configuração da instância mandam o seguinte, e este laboratório não chegou a executar porque não havia um nome público apontando para a máquina:

  1. Crie um registro A do hostname para o IPv4 público da VPS. Se for usar IPv6 de ponta a ponta, crie também o AAAA.
  2. Espere o nome resolver para esse endereço.
  3. No painel, em Settings, grave a URL completa começando com https://, por exemplo https://coolify.example.com, e salve.
  4. O proxy do Coolify, que nesta instalação é o Traefik, emite o certificado quando o nome aponta para o servidor e as portas 80 e 443 estão alcançáveis.

A documentação avisa que a URL não pode ter caminho (https://example.com/coolify não serve) e não deve reutilizar o domínio de uma aplicação. Com a validação de DNS ligada, o Coolify confere o nome antes. Quando o painel abrir pelo domínio, a mesma página de firewall diz que dá para fechar o acesso público às portas 8000, 6001 e 6002.

Enquanto o nome não existir, o que se confirma é o que este teste viu: 80 e 443 no ar, 503, e o certificado padrão do Traefik.

Guardar o .env

O instalador pede para copiar /data/coolify/source/.env para fora do servidor. Esse arquivo tem a APP_KEY e as senhas do banco e do Redis. Sem ele, um backup do banco não volta a abrir.

Nesta instalação o arquivo existia, com 680 bytes, e o diretório /data/coolify estava no modo 700, dono 9999. Confira o modo e leve uma cópia para outro lugar. Não cole o conteúdo em chamado, chat nem repositório.

sudo ls -ld /data/coolify /data/coolify/source
sudo ls -l /data/coolify/source/.env
Enter fullscreen mode Exit fullscreen mode

Uma cópia que fica só neste disco se perde com a VPS. Guarde o .env num gerenciador de senhas ou em outra máquina. Não rode um comando que apague /data/coolify para "reinstalar limpo" sem essa cópia.

A instância ficou no canal stable, com atualização automática ligada e frequência 0 0 * * *. O painel pode se atualizar sozinho. Leia as notas da versão antes de depender de uma data em que isso não possa acontecer.

Problemas comuns

A conta root não abre mais

O instalador avisa na hora: a primeira conta só é aceita nos 10 minutos seguintes à subida. Passou o prazo, rode sudo docker restart coolify e recarregue http://IP_DA_VPS:8000. Crie a conta antes de divulgar o endereço.

A porta 8000 não abre, ou abre para a internet inteira

São dois problemas diferentes. Se o firewall do provedor não libera 8000/tcp, o painel não abre de fora. Se só o ufw está ativo, a porta publicada pelo Docker continua aberta mesmo com ufw deny 8000/tcp. O guia A porta do Docker continua aberta com o ufw mostra as duas respostas HTTP, antes e depois do ufw-docker.

Para liberar o painel com o ufw-docker já instalado, a regra é na porta do contêiner:

sudo ufw route allow proto tcp from any to any port 8080
Enter fullscreen mode Exit fullscreen mode

O proxy responde 503

Foi o que http://127.0.0.1/ e https://127.0.0.1/ responderam antes de qualquer domínio: 503 Service Unavailable. O proxy está no ar e ainda não tem para quem encaminhar. O 503 some quando uma aplicação, ou o próprio painel, ganha um hostname de verdade. Não é falta de memória nem contêiner parado: sudo docker ps mostrava o coolify-proxy saudável.

O certificado é o padrão do Traefik

Se o navegador reclamar do certificado e o openssl mostrar CN = TRAEFIK DEFAULT CERT, o domínio ainda não foi salvo na instância, ou o nome não aponta para esta VPS. Volte à seção de domínio. Não importe esse certificado como se fosse o de produção.

Próximo passo

Com a conta criada, o onboarding do painel pede o servidor, o Docker e o primeiro projeto. O servidor local já está registrado por este instalador. A partir daí o Coolify publica aplicação a partir do Git, no proxy que já escuta 80 e 443.

O plano e o que a contratação inclui estão em VPS para Coolify. Se for publicar outra coisa no mesmo Docker, sem o painel, o caminho com Compose está em Como instalar o n8n com Docker numa VPS.


Publicado originalmente em https://nuvits.net/blog/como-instalar-coolify-vps-ubuntu

Top comments (0)