Coolify na VPS: como instalar e publicar seus apps
Aprenda a instalar o Coolify no seu servidor, criar o admin com segurança, cuidar das portas e publicar apps com domínio, HTTPS, atualização e backup.
Por Redação Eleven Host · @robson.direitodigital · 1 de novembro de 2026 · 8 min de leitura
Capa da Redação Eleven Host para o guia: Coolify na VPS: como instalar e publicar seus apps Arte: Eleven Host
O Coolify na VPS é um painel de código aberto que você instala no seu servidor para publicar sites, apps e bancos de dados pelo navegador, com domínio e HTTPS. Este guia mostra a instalação, o primeiro acesso, o cuidado com as portas e a rotina de atualização e backup.
O que é o Coolify e para quem serve
Segundo a documentação, o Coolify é uma plataforma de código aberto, que você mesmo hospeda, para publicar e gerenciar aplicações, bancos de dados e serviços. O README do projeto no GitHub o descreve como uma alternativa de código aberto e auto-hospedada a plataformas como Vercel, Heroku e Netlify. A licença exibida no repositório é a Apache-2.0.
Ele faz sentido para quem gosta do conforto de uma plataforma de deploy, em que você aponta o código e a plataforma cuida da publicação, mas prefere rodar tudo no próprio servidor em vez de depender de uma plataforma de terceiros. Existe também o Coolify Cloud, versão em que a equipe do Coolify roda o painel de controle. Neste guia o painel roda na sua VPS.
Instalar o Coolify não tira o servidor das suas mãos. Segundo a documentação, quem hospeda por conta própria cuida das atualizações da instância, dos backups e da recuperação, e precisa de uma estratégia de backup e restauração testada.
Se você ainda não sabe o que é uma VPS, comece pelo guia de iniciantes sobre servidor VPS e volte aqui depois.
Requisitos do servidor
A página de instalação do Coolify informa o mínimo para rodar: 2 núcleos de CPU, 2 GB de RAM e 10 GB de disco. A arquitetura pode ser amd64 ou arm64. Confira esses números com o plano de VPS que você escolher antes de instalar.
O Coolify só roda em sistemas baseados em Linux. A documentação lista as famílias Debian e Ubuntu, Red Hat, SUSE, Arch, Alpine e Raspberry Pi OS de 64 bits. Para Ubuntu fora da série LTS, a tabela manda usar a instalação manual. A página pede um servidor com acesso por SSH e recomenda um servidor novo.
Se o Docker no seu servidor veio instalado por snap, remova essa instalação antes de rodar o instalador do Coolify.
Como instalar o Coolify
Entre no servidor por SSH como root e rode o comando de instalação da documentação:
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash
Quando o instalador terminar, abra no navegador o endereço do painel, que usa a porta 8000:
http://<ip-do-servidor>:8000
Na primeira tela, crie a conta de administrador. Faça isso logo que a instalação acabar.
Por que criar o admin logo
A documentação avisa: quem chegar primeiro à página de registro pode se tornar o administrador da instância e assumir o controle de root do seu servidor. Enquanto a conta não existe, o painel na porta 8000 está aberto a quem descobrir o endereço. Crie a sua conta antes de seguir para os próximos passos.
Depois de entrar, faça uma cópia do arquivo /data/coolify/source/.env e guarde num lugar seguro. A documentação pede esse backup, e os valores gerados ali não devem ser alterados depois da instalação.
Portas e firewall do Coolify
A documentação de firewall do Coolify lista as portas do servidor:
- 8000/tcp: painel acessado pelo IP.
- 6001/tcp: atualização em tempo real.
- 6002/tcp: terminal web.
- 22/tcp: SSH.
- 80/tcp: HTTP e emissão de certificado pelo proxy.
- 443/tcp: HTTPS.
Quando o painel passar a abrir por um domínio, atrás do proxy, dá para fechar o acesso público às portas 8000, 6001 e 6002.
Há uma pegadinha com o Docker. A documentação explica que ele adiciona regras de NAT e iptables para as portas de contêiner publicadas, e que bloquear uma porta no UFW não garante que uma porta publicada pelo Docker esteja bloqueada. Por isso, feche essas portas no firewall do provedor ou use uma ferramenta como o ufw-docker, e depois confira de fora se elas realmente estão fechadas. O guia Portas abertas no Linux: como ver com ss e lsof na VPS ajuda a conferir o que está escutando.
Como organizar seus apps no servidor
Se você já usa um painel visual de contêineres, vale comparar com o Portainer na VPS, que gerencia o Docker pelo navegador. Os dois têm propostas diferentes: o Portainer mostra e controla contêineres, enquanto o Coolify acrescenta o fluxo de publicação de aplicações, bancos e serviços.
Quem só quer um servidor web com HTTPS, sem plataforma de deploy, pode olhar o guia Caddy na VPS: servidor web com HTTPS automático. Nesse caso, o proxy do Coolify não entra na conta.
VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS
Publicar o primeiro app
A documentação de introdução diz que o Coolify publica aplicações a partir de um repositório Git, de um Dockerfile, de um Docker Compose ou de uma imagem Docker existente. Os passos de cada origem estão na documentação do Coolify.
Para bancos de dados, a documentação diz que o Coolify roda bancos suportados com armazenamento persistente, controles de ciclo de vida e configuração de backup. Há ainda os serviços de 1 clique, que partem de modelos de Docker Compose.
Se for a sua primeira publicação, escolha um app sem importância para conhecer o caminho do deploy antes de colocar algo importante.
Domínio e HTTPS
O proxy integrado padrão do Coolify é o Traefik. A documentação do proxy diz que ele configura certificados TLS automáticos para domínios HTTPS, usando o resolvedor letsencrypt com desafio HTTP, e que as entradas ficam nas portas 80 e 443.
Na prática, isso pede dois passos fora do painel:
- Apontar o domínio para o servidor. Crie um registro A no DNS do domínio com o IP da VPS. O DNS é onde esse registro é criado.
- Manter as portas 80 e 443 acessíveis. Sem a 80, o desafio HTTP que emite o certificado não funciona.
Depois disso, informe o domínio no app dentro do Coolify. Se a emissão do certificado falhar, a primeira coisa a conferir é se o DNS já aponta para o servidor e se as portas estão abertas.
Atualizar o Coolify e fazer backup
Antes de atualizar, a documentação manda criar um backup da instância, ler as notas da versão e conferir se há algum deploy em andamento.
Há duas formas de atualizar. Pelo painel, vá em Settings, depois Updates, e clique em Upgrade Now. Lá também existe a opção Automatic updates, cuja frequência padrão é 0 0 * * *. Pelo terminal, rode o script de upgrade informando a versão, sem o "v" na frente. O exemplo da documentação usa a 4.3.23, que é só um exemplo e não a versão atual:
curl -fsSL https://cdn.coollabs.io/coolify/upgrade.sh | bash -s 4.3.23
Dois erros a evitar ao atualizar
- Não rode o
install.shde novo para atualizar. A documentação diz que ele reseta o dono e as permissões em/data/coolify. - Não omita a versão no
upgrade.sh. Sem ela, o script gravaCOOLIFY_VERSION=lateste quebra a checagem.
Sobre backups de banco de dados, o Coolify cria backups agendados, específicos de cada motor, para PostgreSQL, MySQL, MariaDB, MongoDB, ClickHouse e SQLite. Redis, Dragonfly e KeyDB não usam esse fluxo agendado. Os backups podem ser copiados para um armazenamento compatível com S3, e as regras de retenção local e S3 são independentes.
Duas frases da documentação merecem atenção. Um backup bem-sucedido prova apenas que o Coolify criou um arquivo, então teste a restauração. E, se o banco estiver parado quando o horário agendado chegar, o Coolify pula aquela execução. A documentação fala de backup de banco, e não de arquivos ou volumes de aplicação: para esses, defina outra rotina.
Checklist depois de instalar
- Criei a conta de administrador logo após a instalação.
- Guardei uma cópia de
/data/coolify/source/.envem lugar seguro, sem alterar os valores gerados. - Conferi de fora quais portas estão abertas, sem confiar só no UFW.
- Apontei o domínio para o servidor e mantive as portas 80 e 443 acessíveis.
- Depois que o painel abriu por domínio, fechei o acesso público às portas 8000, 6001 e 6002.
- Configurei backup dos bancos de dados e testei uma restauração.
- Defini como atualizar: backup da instância, notas da versão e
upgrade.shcom a versão informada. - Publiquei primeiro um app sem importância para conhecer o deploy.
Quer o seu painel de deploy num servidor só seu? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer a VPS
Perguntas frequentes
O que é o Coolify?
É uma plataforma de código aberto, que você hospeda, para publicar e gerenciar aplicações, bancos de dados e serviços.
Quais são os requisitos para instalar o Coolify?
A documentação informa 2 núcleos de CPU, 2 GB de RAM e 10 GB de disco, num sistema baseado em Linux.
Em qual porta fica o painel do Coolify?
Na instalação, o painel abre pelo IP do servidor na porta 8000. Quando ele passa a abrir por domínio, atrás do proxy, dá para fechar o acesso público às portas 8000, 6001 e 6002.
Posso atualizar o Coolify rodando o instalador de novo?
Não. A documentação diz que o install.sh reseta o dono e as permissões em /data/coolify. Atualize pelo painel ou pelo upgrade.sh com a versão informada.
O Coolify faz backup dos meus arquivos?
A documentação descreve backups agendados de banco de dados. Para arquivos e volumes de aplicação, defina uma rotina própria.
