Manual do Coolify
Coolify na sua VPS, do primeiro comando ao deploy automático
O manual completo do Coolify em português: instale na VPS, publique pelo Git, ligue o seu domínio com HTTPS, crie bancos com backup e mantenha tudo seguro. Cada passo com a tela real do painel.
- 21 guias passo a passo
- Telas reais do Coolify 4.7.5
- Botões em inglês com tradução
- Repositório Gito código no GitHub, GitLab ou outro Git
- Build na VPSo Coolify monta a imagem com Railpack, Dockerfile ou Compose
- Contêiner no ara versão nova entra e a antiga sai
- Domínio com HTTPSo proxy entrega o seu domínio e emite o certificado
Comece aqui
Sua primeira aplicação no ar, em oito passos
Na ordem, da instalação na VPS ao backup do banco. Cada passo abre o tutorial completo, com as telas.
- Instale o Coolify na VPSUm comando como root e o painel abre na porta 8000.
- Crie a conta de administradorLogo depois de instalar, e conheça o painel.
- Ponha o painel no seu domínioCom HTTPS, no lugar do IP e da porta 8000.
- Organize com projetosUm projeto por cliente ou sistema, com ambientes.
- Publique pelo GitDo repositório ao primeiro deploy, com o log.
- Ligue o domínio da aplicaçãoDNS, HTTPS automático e o redeploy.
- Crie o banco de dadosPostgreSQL, MySQL ou MariaDB pelo painel.
- Agende o backupBackup diário e cópia fora da VPS.
Atalhos
O que você quer fazer?
- Publicar a cada pushDeploy automático pelo Git e volta para a versão anterior.
- Ligar meu domínioDNS, HTTPS automático, www e redirecionamentos.
- Não perder dadosBackup agendado do banco e cópia fora da VPS.
- Ver o que está acontecendoLogs, terminal no navegador e métricas.
- Deixar o painel seguro2FA, cadastro fechado, portas e tokens da API.
- Entender os botõesO painel em inglês, traduzido menu a menu.
Biblioteca
Todos os guias do manual
Organizados por assunto. Cada guia diz o nível, o que você precisa antes e como saber se deu certo.
Primeiros passos
Da instalação na VPS ao painel no seu domínio, com HTTPS.
- Primeiros passosO que é o Coolify e como ele funciona na sua VPSO que o Coolify faz, os conceitos do painel (servidor, projeto, ambiente, recurso, proxy e equipe) e o que fica com você.Iniciante
- Primeiros passosComo 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.Iniciante
- Primeiros passosPrimeiro acesso ao Coolify: conta de administrador e painelO cadastro do administrador, as três etapas das boas-vindas, o menu lateral item por item e o cadastro fechado depois.Iniciante
- Primeiros passosPainel do Coolify no seu domínio, com HTTPSDo IP com a porta 8000 ao painel em https://painel.example.com, com o certificado automático e as portas certas no firewall.Intermediário
- Primeiros passosO painel do Coolify em português: glossário de menus e botõesOs menus, botões e status do Coolify com a tradução e para que servem, divididos por área do painel.Iniciante
Publicar aplicações
Projetos, deploy pelo Git, build packs, domínios e variáveis.
- Publicar aplicaçõesProjetos e ambientes no Coolify: como organizar suas aplicaçõesCrie o projeto, conheça o ambiente production que já vem pronto e adicione um ambiente staging para testar antes de publicar.Iniciante
- Publicar aplicaçõesComo publicar uma aplicação pelo Git no CoolifyDo endereço do repositório à aplicação no ar: build automático com o Railpack, o log do deploy e o endereço provisório.Iniciante
- Publicar aplicaçõesComo publicar um repositório privado no CoolifyDois caminhos para o Coolify ler um repositório privado: o GitHub App, com deploy automático, e a deploy key, uma chave SSH só de leitura.Intermediário
- Publicar aplicaçõesBuild packs no Coolify: Railpack, Dockerfile, Compose e imagem prontaO que muda entre Railpack, Static, Dockerfile, Docker Compose e imagem pronta, quando usar cada um e a porta que cada um espera.Intermediário
- Publicar aplicaçõesComo ligar um domínio com SSL a uma aplicação no CoolifyDo registro DNS ao site em HTTPS: Add Domain, o aviso DNS mismatch, a remoção do endereço provisório, os redirecionamentos e o Redeploy.Iniciante
- Publicar aplicaçõesVariáveis de ambiente no Coolify: como criar e protegerConfiguração e segredos fora do código: a janela de variável, build time e runtime, a Developer View, as variáveis compartilhadas e o Redeploy.Intermediário
Bancos e serviços
Bancos de dados, backup e aplicações prontas do catálogo.
- Bancos e serviçosComo criar um banco de dados no CoolifyDo grupo Databases ao banco rodando: imagem, nome, credenciais, o endereço interno para a aplicação e o acesso público, que fica fechado.Iniciante
- Bancos e serviçosComo fazer backup do banco de dados no CoolifyBackup agendado do banco pelo painel: frequência em cron, retenção, cópia em armazenamento compatível com S3 e a restauração.Intermediário
- Bancos e serviçosComo instalar serviços prontos no CoolifyO catálogo de serviços do Coolify na prática: buscar o modelo, publicar, abrir no navegador, ligar o domínio e atualizar com segurança.Iniciante
Operação do dia a dia
Deploy automático, logs, terminal, volumes e tarefas agendadas.
- Operação do dia a diaDeploy automático, webhooks e rollback no CoolifyDeploy a cada push, webhook manual com segredo, deploy pela API, rollback para uma imagem anterior e prévias de pull request.Intermediário
- Operação do dia a diaLogs, terminal e monitoramento no CoolifyAs ferramentas para entender o que a aplicação está fazendo: logs, terminal web, healthcheck, limites de CPU e memória e métricas.Intermediário
- Operação do dia a diaVolumes e tarefas agendadas no CoolifyPersistent storage para os dados que precisam sobreviver ao deploy e Scheduled tasks para rodar comandos na hora marcada, dentro do contêiner.Intermediário
Administração e segurança
Equipe, notificações, segurança, atualização e o servidor.
- Administração e segurançaEquipe e notificações no CoolifyOs papéis Owner, Admin e Member, o convite por link e os avisos de deploy, backup e servidor no canal que a sua equipe já usa.Iniciante
- Administração e segurançaSegurança do Coolify: checklist para a sua VPSOs itens que fecham o painel e o servidor: 2FA, cadastro, domínio com HTTPS, portas, API, chaves, banco, o arquivo .env e as atualizações do Ubuntu.Intermediário
- Administração e segurançaComo atualizar e manter o CoolifyBackup antes, atualização pelo painel ou pelo upgrade.sh, limpeza do Docker, o proxy, a conexão com o servidor e uma segunda VPS quando a primeira ficar pequena.Intermediário
Solução de problemas
Os erros mais comuns, a causa provável e o que fazer.
Coolify na Hospedagem Segura
Escolha como quer rodar o seu Coolify
Na VPS Linux a partir de R$ 69,90/mês, você tem acesso root e instala o Coolify com um comando, como mostra este manual. No VPS Assistido a partir de R$ 119,90/mês, o Coolify já vem instalado na entrega, com o painel no seu domínio e HTTPS, firewall com as portas do perfil e ajuda da equipe para ligar domínios, abrir portas e diagnosticar deploys.
- Vai instalar sozinho? Comece pela instalação
- Quer o Coolify pronto? Veja o VPS Assistido
- Comparar planos? Planos da VPS Linux
Perguntas frequentes
Respostas rápidas sobre o Coolify
O que é o Coolify?
O Coolify é uma plataforma de código aberto para publicar aplicações, bancos de dados e serviços no seu próprio servidor, com painel web, deploy pelo Git e certificado SSL automático. Ele roda numa VPS e faz o papel de plataformas como Heroku, Vercel e Netlify, com o custo fixo do servidor.
O Coolify tem painel em português?
Não. O painel do Coolify é em inglês e não tem opção de idioma. Este manual mostra cada botão como ele aparece na tela, com a tradução, e tem um glossário com os menus traduzidos.
Qual VPS escolher para o Coolify?
O Coolify pede no mínimo 2 núcleos e 2 GB de memória só para ele, e o build das aplicações roda na mesma VPS. Na Hospedagem Segura, comece pelo plano de 4 GB (2 vCPU, 50 GB NVMe); para vários projetos ou bancos maiores, o de 8 GB (4 vCPU, 100 GB NVMe).
O Coolify é grátis?
Sim. O Coolify tem código aberto, sob a licença Apache 2.0, e a versão instalada no seu servidor tem todos os recursos. Você paga só pela VPS.
Preciso saber Docker para usar o Coolify?
Para começar, não. O Coolify detecta a linguagem do repositório e monta a imagem sozinho com o Railpack. Docker ajuda quando a aplicação precisa de um Dockerfile ou de Docker Compose próprios, e o manual mostra os dois caminhos.
O Coolify faz backup?
Sim, dos bancos de dados: PostgreSQL, MySQL, MariaDB e MongoDB têm backup agendado pelo painel, com cópia opcional num armazenamento compatível com S3. Volumes de aplicação e o próprio servidor precisam de outra cópia; no VPS Assistido, a Hospedagem Segura faz backup da VPS inteira duas vezes por semana.
Ainda não tem a VPS para o Coolify?
VPS Linux com acesso root, disco NVMe e IPv4 dedicado a partir de R$ 69,90/mês, ou o VPS Assistido com o Coolify pronto na entrega.