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
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
No terminal, o fim foi este:
Coolify is ready! Installed in 1m 27s
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
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"
}
}
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
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
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
PORTSsó mostra a porta interna. - A imagem
coollabsio/coolify-helper:1.0.19foi baixada e não ficou como contêiner permanente. - O servidor local que o instalador registrou se chama
localhost, aponta parahost.docker.internalna porta 22, com o usuárioroot. O proxy desse servidor ficou como Traefik em execução.
Confira no seu servidor com:
sudo docker ps
sudo docker compose version
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
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
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/respondeuHTTP/1.1 302 Foundpara/login. -
http://203.0.113.1/respondeuHTTP/1.1 503 Service Unavailable. -
https://203.0.113.1/respondeuHTTP/2 503. -
http://203.0.113.1:6001/ehttp://203.0.113.1:6002/responderamHTTP/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
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
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:
- 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.
- Espere o nome resolver para esse endereço.
- No painel, em Settings, grave a URL completa começando com
https://, por exemplohttps://coolify.example.com, e salve. - 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
Uma cópia que fica só neste disco se perde com a VPS. Guarde o
.envnum gerenciador de senhas ou em outra máquina. Não rode um comando que apague/data/coolifypara "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
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)