O que é o Coolify: conceitos e como funciona na VPS

Resposta rápida

O Coolify é uma plataforma self-hosted (auto-hospedada) e de código aberto, sob a licença Apache 2.0, que publica aplicações, bancos de dados e serviços no seu próprio servidor. Você liga o repositório Git, e ele monta a imagem, coloca a aplicação no ar em contêineres Docker e emite o certificado SSL pelo proxy. É uma alternativa a plataformas como Heroku, Vercel e Netlify, com o preço fixo da VPS.

O painel do Coolify é em inglês. Neste manual, os botões aparecem como estão na tela, em negrito, com a tradução ao lado. Dúvida com algum termo? Veja o glossário do Coolify em português.

Você vai aprender

O que o Coolify faz e por que ele roda no seu próprio servidor
O que são Server, Project, Environment, Resource, Destination, proxy e Team
Como o Coolify funciona na VPS e qual plano escolher
O que o Coolify não faz e continua com quem administra a VPS

Neste guia

O que o Coolify faz
Os conceitos do painel
Como é o painel
Como o Coolify funciona na VPS da Hospedagem Segura
O que o Coolify não faz
Problemas comuns

O que o Coolify faz

O Coolify é um painel web que você instala na sua VPS para publicar aplicações a partir do Git, subir bancos de dados e instalar serviços prontos, cada um no seu domínio, com SSL. Ele é um software de código aberto, sob a licença Apache 2.0, mantido pelo próprio projeto Coolify. A instalação no seu servidor é gratuita e tem todos os recursos: você paga só a VPS.

Repositório Gito código da aplicação, no GitHub, GitLab ou outro Git
Buildo Coolify baixa o código e monta a imagem Docker
Contêinera aplicação roda num contêiner na VPS
Proxy e HTTPSo proxy entrega o domínio à aplicação e cuida do certificado

Do código ao site no ar, dentro da sua VPS

Os conceitos do painel

O painel é em inglês, e estes nomes aparecem em todas as telas. Vale conhecer cada um antes da primeira aplicação.

Server (servidor)A máquina onde rodam aplicações, bancos e serviços. O Coolify fala com ela por SSH.
localhostO servidor que já vem cadastrado: a própria VPS do Coolify. Divide CPU e memória com o painel e não pode ser removido.
Project (projeto)Um grupo de ambientes e recursos. Use um por site, sistema ou cliente.
Environment (ambiente)Uma divisão do projeto. Ele nasce com production; crie outro, como staging, para testar antes.
Resource (recurso)Cada item publicado: uma aplicação, um banco de dados ou um serviço pronto.
Destination (destino)A rede Docker onde os recursos rodam. A da instalação se chama coolify, e quem está nela se fala pelo nome.
ProxyO Traefik, padrão: recebe as portas 80 e 443, entrega cada domínio e emite o certificado SSL.
Team (equipe)As pessoas que usam o painel, cada uma com um papel: Owner, Admin ou Member.

Como os conceitos se encaixam, do maior para o menor

Teama equipe
Projecto projeto, como a Loja Virtual
Environmento ambiente, como production
Resourcea aplicação site-da-loja ou o banco banco-da-loja

Cada recurso roda num servidor (no começo, o localhost) e numa rede Docker (a Destination).

Como é o painel

Página inicial do Coolify (Dashboard): os projetos, os servidores com o status Ready e os deploys recentes, com o menu lateral à esquerda

A página inicial (Dashboard), com o menu lateral à esquerda.

Projects (projetos) os projetos da equipe, com os ambientes e recursos de cada um.
Servers (servidores) os servidores ligados ao painel. Na VPS, o primeiro é o localhost.
Recent deployments (deploys recentes) os últimos deploys, com o resultado.

Dentro do projeto, cada ambiente é um cartão. Separar o site no ar dos testes evita mexer em produção por engano.

Projeto Loja Virtual com dois ambientes no Coolify: production, para o site no ar, e staging, para testar antes

O projeto Loja Virtual com dois ambientes.

production o ambiente que nasce com o projeto, para o que está no ar.
staging um ambiente criado para testar antes de publicar.

Como o Coolify funciona na VPS da Hospedagem Segura

O Coolify roda em contêineres Docker na própria VPS. O instalador gera uma chave SSH para o painel entrar no servidor localhost e, por ela, o Coolify cria redes, monta imagens e sobe contêineres. O proxy ocupa as portas 80 e 443, e o build das aplicações roda na mesma VPS.

O Coolify pede no mínimo 2 núcleos e 2 GB de memória só para ele. O plano de 4 GB (2 vCPU, 50 GB NVMe) é o ponto de partida. Para vários projetos, builds pesados ou bancos maiores, comece pelo de 8 GB (4 vCPU, 100 GB NVMe).

VPS Linux ou VPS Assistido para rodar o Coolify
Item	VPS Linux	VPS Assistido
Preço	a partir de R$ 69,90/mês	a partir de R$ 119,90/mês
Instalação do Coolify	Você instala, como root	Já vem instalado na entrega
Painel no domínio, com SSL	Você configura	Já vem no domínio que você informar
Firewall e SSH	Você configura no servidor	Portas do perfil e hardening inicial do SSH
Ajuda da equipe	Você administra (não gerenciado)	Ligar domínio, abrir portas e diagnosticar deploy

A VPS Linux serve a quem já administra servidores. O VPS Assistido entrega o Coolify pronto e conta com a equipe para tarefas pontuais.

O que o Coolify não faz

O sistema operacional continua com quem administra a VPS

A documentação do Coolify é direta: ele não cuida da segurança nem das atualizações do servidor. As atualizações do Ubuntu ou do Debian, o firewall e o acesso por SSH continuam com quem administra a VPS.

Atualizar o Coolify muda só o painel, não as aplicações, os bancos e os serviços.
Volume não é backup: o backup dos bancos é um agendamento à parte.
O backup do próprio Coolify não leva os dados das aplicações nem o .env com a APP_KEY, que você guarda à parte.
O código, o Dockerfile e o arquivo Compose da aplicação continuam sendo seus.

Como saber se deu certo

Você sabe o que o Coolify faz, reconhece os nomes do painel e sabe o que continua sendo tarefa de quem administra a VPS.

Problemas comuns

A VPS fica lenta quando várias aplicações e builds rodam juntos

Causa provável: No localhost, o painel, as aplicações, os bancos e os builds dividem a mesma CPU e a mesma memória.
O que fazer: Veja o consumo em logs e monitoramento. Reduza o que roda junto ou passe para um plano com mais memória.

Não há opção para remover o servidor localhost

Causa provável: O localhost é o servidor do próprio Coolify, e a documentação diz que ele não pode ser removido.
O que fazer: É o comportamento esperado. Use o localhost para as aplicações ou ligue outra VPS ao painel por SSH.

O Coolify está atualizado, mas o sistema da VPS tem atualizações pendentes

Causa provável: O Coolify não atualiza o sistema operacional.
O que fazer: Atualize o Ubuntu ou o Debian pelo SSH, como em qualquer servidor. Veja segurança do Coolify. No VPS Assistido, abra um chamado na central do cliente se tiver dúvida.

Não resolveu? Veja os problemas comuns do Coolify ou abra um chamado na central do cliente.

Próximo passoComo instalar o Coolify na VPSRequisitos, acesso por SSH, o comando oficial, a janela de 10 minutos para a primeira conta e a cópia do arquivo .env.

Fontes e documentação oficial

Coolify é um software de código aberto mantido pelo próprio projeto. Este manual é da Hospedagem Segura, para quem roda o Coolify nas nossas VPS, e foi conferido na versão 4.7.5.

Continue aprendendo

Ver todos os guias do Manual do Coolify

Rode o Coolify numa VPS da Hospedagem Segura

VPS Linux com acesso root, disco NVMe e IPv4 dedicado a partir de R$ 69,90/mês. Prefere a VPS pronta? No VPS Assistido, o Coolify vem instalado, com o painel no seu domínio, e a equipe ajuda no dia a dia.

Ver VPS para Coolify Conhecer o VPS Assistido