Como instalar o Coolify em um VPS

Pré-requisitos

Seu VPS deve atender aos requisitos mínimos oficiais: 2 vCPU, 2 GB de RAM, 30 GB de disco, Ubuntu 22.04 ou 24.04, um endereço IPv4 público, acesso root ou sudo e SSH habilitado.

Antes de se conectar, crie um registro A, como coolify.example.com, apontando para o IP do servidor. A propagação do registro DNS pode levar algum tempo. Você também precisa de um cliente SSH local e conhecimentos básicos de gerenciamento de pacotes, permissões de arquivos e regras de firewall.

Não coloque credenciais nos comandos deste artigo. Você criará a conta de administrador no navegador e deve usar um gerenciador de senhas para os segredos gerados.

Observação: versões do Ubuntu que não são LTS (por exemplo, 24.10, 25.04) não têm suporte oficial e exigem etapas manuais de instalação.

Etapa 1, Conectar ao servidor

Conecte-se como o administrador fornecido pelo provedor do VPS e atualize o sistema operacional:

ssh root@SERVER_IP
apt update && apt upgrade -y
apt install -y curl ca-certificates git

Substitua SERVER_IP pelo endereço real. Se o provedor fornecer um usuário sem privilégios de root, acrescente sudo aos comandos de pacotes e use sudo -i somente se o provedor recomendar.

Defina o nome do servidor se a máquina for dedicada a esta instalação e confirme que o relógio e o resolvedor DNS estão funcionando. Evite instalar outro servidor web que já escute nas portas 80 ou 443. O proxy do Coolify precisa dessas portas para HTTP, HTTPS e validação de certificados.

Etapa 2, Instalar o Docker e o Docker Compose

Instale o Docker Engine e o plugin Compose seguindo as instruções oficiais do Docker para sua versão do Ubuntu. Os nomes dos pacotes normalmente incluem docker-ce, docker-ce-cli, containerd.io, docker-buildx-plugin e docker-compose-plugin.

Depois da instalação, verifique os dois comandos:

docker --version
docker compose version
systemctl enable --now docker

Não copie comandos de instalação de blogs sem confiança. A configuração do repositório do Docker muda com o tempo, então use as instruções atuais do Docker para Ubuntu. Uma verificação de versão bem-sucedida só confirma que o ambiente de execução existe, não que o servidor esteja pronto para produção.

Importante: Se instalar o Docker previamente, use o repositório apt oficial do Docker. O Docker instalado pelo Snap NÃO tem suporte no Coolify e VAI interromper a instalação.

Etapa 3, Executar o Coolify com o instalador oficial

O Coolify publica um instalador oficial de uma linha que prepara seus contêineres Docker e a configuração de suporte:

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

O instalador cria os dados da aplicação e inicia os serviços necessários. Quando terminar, verifique os contêineres e os logs recentes:

docker ps
docker compose ls
docker logs --tail 100 coolify

Os nomes exatos dos contêineres podem variar conforme a versão. Se coolify não for o nome exibido por docker ps, use o nome ou projeto mostrado ali. Não exclua volumes durante a investigação de problemas, pois eles contêm a configuração do painel e os metadados das implantações.

Aviso: Imediatamente após a instalação, crie a conta de administrador pela interface web em http://SERVER_IP:8000. Se outra pessoa se cadastrar primeiro, ela poderá assumir o controle da sua instância do Coolify.

Etapa 4, Configurar o proxy reverso

O Coolify inclui um proxy Traefik integrado que gerencia o Let's Encrypt para as aplicações implantadas. Você NÃO precisa configurar um proxy reverso separado no servidor. Basta manter as portas 80 e 443 abertas no servidor.

Permita o tráfego TCP de entrada nas portas 80 e 443 e restrinja o SSH à faixa de IPs de administração, se o provedor oferecer essa regra. Uma configuração mínima de firewall no servidor:

ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable
ufw status

No painel do Coolify, adicione o servidor, escolha o proxy de implantação e configure seu domínio. Aponte o registro DNS do domínio para o VPS antes de solicitar um certificado. O Coolify pode solicitar e renovar um certificado Let's Encrypt quando o domínio resolver corretamente e o proxy puder acessar as portas 80 e 443.

Etapa 5, Primeiro acesso e configuração inicial

Abra o endereço da instalação no navegador. Conclua a configuração inicial do administrador, entre e altere imediatamente quaisquer valores temporários. Adicione um projeto somente depois de confirmar que o servidor está online e que o proxy está íntegro.

Para uma primeira implantação segura, use uma aplicação de teste pequena e sem estado. Confirme que o domínio da aplicação resolve por HTTPS, que o contêiner reinicia após uma reinicialização do servidor e que os logs estão visíveis no painel. Adicione bancos de dados somente depois de decidir como os volumes serão incluídos nos backups.

Manutenção

Confira as notas da versão antes de cada atualização do Coolify. Faça backup do diretório de dados do Coolify e de todos os volumes das aplicações em um armazenamento fora do VPS. Mantenha as imagens Docker e os logs antigos sob controle e monitore o uso do disco com df -h e o uso dos contêineres com docker system df.

Se uma atualização falhar, colete docker ps, docker compose ls e os logs dos serviços relevantes antes de alterar a configuração. Não execute comandos de limpeza abrangentes que removam volumes não utilizados sem confirmar que nenhuma aplicação implantada depende deles.