Implantar Coolify em VPS com uma Imagem Pré-Instalada

Implante o Coolify na infraestrutura VPS quando você quiser uma plataforma auto-hospedada para construir e operar aplicativos, bancos de dados e serviços em um servidor que você controla. A imagem do aplicativo VoyraCloud remove o trabalho inicial de instalação do Coolify, enquanto você continua responsável pelos projetos, credenciais, domínios, dados, atualizações, backups, segurança e capacidade do VPS.

TL;DR

A imagem Coolify do VoyraCloud fornece Coolify no Ubuntu 24.04 LTS para configurações elegíveis de Cloud VPS e Residential IP VPS.
Crie o primeiro administrador do Coolify através do túnel SSH mostrado nos detalhes do recurso VPS. Não exponha uma página de registro não inicializada para a internet pública.
O endereço do painel local inicial é http://127.0.0.1:8000 enquanto o túnel SSH estiver aberto. Não é uma URL pública.
As portas 80 e 443 são usadas pelo proxy do Coolify para aplicativos implantados, validação de domínio e HTTPS. As portas de gerenciamento 8000, 6001 e 6002 permanecem fora da internet pública.
Direcione seu próprio domínio para o VPS e insira um https:// FQDN no Coolify para permitir que seu proxy solicite e renove um certificado Let’s Encrypt.
O Coolify pode implantar a partir de repositórios Git, Dockerfiles, Docker Compose e imagens de contêiner pré-construídas, mas builds e bancos de dados consomem os mesmos recursos do VPS, a menos que você os mova para outro lugar.
Faça backup tanto da instância do Coolify quanto do próprio banco de dados de cada aplicativo, volume persistente, arquivos e segredos. Um backup do banco de dados do Coolify sozinho não é um backup completo do aplicativo.
O VoyraCloud não atualiza automaticamente sua instância do Coolify após a entrega. Revise as versões, faça backup primeiro e atualize deliberadamente.

O que é o Coolify?

Coolify é uma plataforma de implantação auto-hospedada e de código aberto para executar aplicativos, bancos de dados e serviços compatíveis com Docker em servidores que você controla. Ele fornece um painel web para conectar repositórios de origem, construir aplicativos, gerenciar variáveis de ambiente, visualizar logs, atribuir domínios, operar bancos de dados e controlar implantações.

O Coolify se descreve como uma alternativa auto-hospedável a plataformas como Heroku, Netlify e Vercel. A diferença importante é a propriedade operacional: o Coolify roda na sua infraestrutura, e suas cargas de trabalho permanecem em servidores que você administra. A plataforma adiciona automação de implantação, mas não transforma um VPS auto-gerenciado em um serviço de hospedagem gerenciado.

A introdução oficial do Coolify lista implantação baseada em Git, serviços compatíveis com Docker, domínios personalizados, gerenciamento automático de certificados, backups para armazenamento compatível com S3, webhooks, uma API, monitoramento e um terminal de navegador entre suas capacidades.

O Coolify é uma boa opção quando você quer:

Implantar sites, APIs, trabalhadores e aplicativos full-stack a partir do Git.
Executar imagens Docker ou projetos Docker Compose através de uma única interface.
Operar cargas de trabalho de desenvolvimento, staging ou pequenas produções em seu próprio servidor.
Gerenciar domínios, variáveis de ambiente, logs de implantação e verificações de saúde de forma centralizada.
Hospedar bancos de dados e serviços ao lado de aplicativos quando o VPS tiver capacidade suficiente.

É menos adequado quando ninguém pode assumir a administração do Linux, segurança de aplicativos, recuperação de bancos de dados ou resposta a incidentes. Um painel amigável reduz o trabalho repetitivo; não elimina a necessidade de um operador.

O que a imagem Coolify do VoyraCloud inclui?

A imagem do aplicativo inclui um ambiente de início do Coolify testado, não um aplicativo de negócios pré-construído ou uma plataforma gerenciada. Ela permite que você comece no fluxo do primeiro administrador do Coolify em vez de instalar manualmente as dependências do sistema operacional e o Coolify.

Incluído com a imagem	Gerenciado pelo usuário ou não incluído
Ubuntu 24.04 LTS	Seu código e arquitetura de aplicativo
Versão fixa do Coolify testada na criação do recurso	Atualizações automáticas do Coolify após a entrega
Serviços Coolify baseados em Docker e proxy integrado	Um site implantado, API, banco de dados ou serviço de um clique
Configuração persistente do Coolify no disco do VPS	Recuperação automática de desastres fora do servidor
Recuperação de serviço após uma reinicialização normal do VPS	Alta disponibilidade ou failover automático
Instruções do túnel SSH para o primeiro acesso	Um administrador do Coolify pré-criado
Portas públicas 80 e 443 para aplicativos e HTTPS	Um nome de domínio ou gerenciamento de DNS
Portas de gerenciamento apenas locais	Exposição pública da página de registro
Acesso total de administração do VPS	Operações gerenciadas de Linux, banco de dados ou aplicativo

A página de recursos registra a versão do Coolify entregue quando o VPS é criado. Se você atualizar o Coolify mais tarde, esse valor exibido não se torna um inventário de software ativo.

Para um ambiente de contêiner de nível inferior sem uma plataforma de implantação, compare este modelo com o guia Docker no VPS com Portainer. Docker e Portainer expõem primitivas de contêiner diretamente, enquanto o Coolify adiciona fluxos de trabalho de construção, domínio, implantação e serviço orientados a aplicativos.

Como você implanta o Coolify no VPS a partir da imagem do aplicativo?

Comece criando um VPS elegível do VoyraCloud, abrindo os detalhes do Aplicativo e usando o túnel SSH fornecido antes de criar o primeiro administrador. O túnel é essencial porque a página de registro inicial pode conceder controle sobre a instância do Coolify e o servidor que ela gerencia.

1. Crie um VPS com a imagem do Coolify

Abra a página do Coolify do VoyraCloud, continue para o fluxo de compra e selecione uma configuração elegível de Cloud VPS ou Residential IP VPS. Escolha qualquer região atualmente oferecida pelo produto selecionado e confirme que o Coolify está selecionado na seção Imagens.

VoyraCloud Cloud VPS é a escolha de uso geral para hospedagem de aplicativos, builds, APIs, bancos de dados e ferramentas de desenvolvedor. O Residential IP VPS também é suportado quando uma carga de trabalho legítima precisa especificamente das características de rede desse produto, mas um IP residencial não torna o Coolify mais rápido, seguro ou mais fácil de operar.

O guia de instalação oficial do Coolify afirma um mínimo de dois núcleos de CPU, 2 GB de RAM e 30 GB de armazenamento livre. Isso é um piso inicial para a plataforma, não uma promessa de capacidade para os aplicativos que você implanta. Builds, bancos de dados, logs, imagens de contêiner e dados persistentes consomem recursos adicionais.

2. Copie o comando do túnel SSH

Espere até que o VPS esteja pronto, então copie o comando completo do túnel SSH da seção Aplicativo da página de recursos. Ele usa o nome de usuário SSH real, a porta SSH e o endereço público do seu VPS.

O comando segue esta estrutura:

ssh -p {ssh_port} \
  -L 8000:127.0.0.1:8000 \
  -L 6001:127.0.0.1:6001 \
  -L 6002:127.0.0.1:6002 \
  {ssh_user}@{server_ip}

Mantenha a sessão SSH aberta. Os três encaminhamentos suportam o painel, comunicação em tempo real e terminal do navegador. Fechar a sessão SSH fecha o túnel, mas não para o Coolify no VPS.

Se uma dessas portas locais já estiver em uso no seu computador, altere apenas o número do lado esquerdo desse mapeamento. Por exemplo, -L 18000:127.0.0.1:8000 usa a porta local 18000 enquanto ainda alcança o Coolify na porta do servidor 8000. Use a URL local correspondente no seu navegador.

3. Crie o primeiro administrador

Abra http://127.0.0.1:8000 enquanto o túnel estiver conectado e crie o primeiro administrador do Coolify imediatamente. Use um endereço de e-mail exclusivo e uma senha forte que não seja reutilizada em outro lugar.

O endereço é local para o seu computador e funciona apenas através da conexão SSH autenticada. Não o substitua por http://{server_ip}:8000 ou abra portas de gerenciamento para a internet como um atalho. O guia de instalação oficial do Coolify alerta que outra pessoa que acessar uma página de registro não inicializada primeiro pode obter controle total do servidor.

Após o registro:

Faça login com o novo administrador.
Confirme que o servidor localhost parece acessível.
Revise as configurações de atualização e mantenha as atualizações automáticas desativadas para operação controlada em produção.
Verifique o uso de disco e memória antes de implantar um aplicativo.
Mantenha o túnel SSH como o caminho de gerenciamento até que você configure um domínio confiável.

4. Implemente um pequeno primeiro aplicativo

Use um pequeno repositório público ou uma imagem de contêiner pré-construída para a primeira implantação para que você possa validar o caminho completo antes de adicionar um banco de dados ou credenciais privadas. O Coolify suporta repositórios Git públicos e privados, Dockerfiles, Docker Compose, imagens Docker pré-construídas e pacotes de construção.

Um primeiro teste controlado deve verificar:

O Coolify pode alcançar a fonte selecionada.
A construção termina sem esgotar CPU, memória ou disco.
O contêiner do aplicativo se torna saudável.
Os logs são visíveis e não contêm erros recorrentes de inicialização.
O aplicativo responde através do seu domínio atribuído.
Uma reinicialização do VPS não remove sua configuração ou dados persistentes.

O repositório de exemplos do Coolify contém pequenos exemplos de aplicativos adequados para aprendizado. Revise o exemplo antes da implantação, pois o código público ainda é uma entrada de terceiros executando em seu servidor.

Como funcionam domínios e HTTPS no Coolify?

O Coolify pode configurar seu proxy e solicitar um certificado Let’s Encrypt depois que seu domínio resolver para o VPS e você inserir um https:// FQDN. O VoyraCloud não inclui o domínio ou controla seus registros DNS.

Para o painel do Coolify ou um aplicativo implantado:

Crie um registro A que aponte o nome do host escolhido para o endereço IPv4 do VPS.
Espere até que o DNS público retorne o endereço esperado.
Insira o nome do host completo no Coolify usando o esquema https://.
Mantenha as portas TCP públicas 80 e 443 acessíveis para que o proxy possa servir tráfego e completar a validação do certificado.
Espere pela emissão do certificado, então abra a URL final HTTPS.
Confirme que o HTTP simples redireciona para HTTPS e que o navegador não mostra nenhum aviso de certificado.
Teste o comportamento de renovação antes que o certificado se torne crítico para um serviço de produção.

O guia oficial de domínios do Coolify explica que inserir um FQDN HTTPS faz com que o proxy integrado Traefik ou Caddy gere a configuração de roteamento, solicite um certificado Let’s Encrypt e gerencie a renovação. Se a emissão falhar, o Coolify pode servir um certificado autoassinado, o que mantém o endpoint acessível, mas ainda causa um aviso no navegador. Trate esse aviso como uma configuração de HTTPS confiável falhada e corrija DNS, acessibilidade, limites de taxa ou configuração do proxy.

Depois que um domínio de painel confiável funcionar, você pode continuar usando o túnel SSH ou usar o domínio HTTPS de acordo com sua política de acesso. Não publique as portas 8000, 6001 ou 6002 simplesmente porque o painel tem uma senha de administrador. A orientação de firewall do Coolify permite que essas portas sejam fechadas quando um domínio personalizado e um proxy integrado estão em uso.

Qual método de implantação você deve escolher?

Escolha o método de implantação mais simples que corresponda à forma como seu aplicativo é construído e mantido. Cada camada de construção extra ou serviço público aumenta o uso de recursos e o trabalho operacional.

Método de implantação	Melhor ajuste	Principal responsabilidade
Pacote de construção	Frameworks comuns com estrutura de projeto convencional	Verificar comandos de construção e inicialização detectados
Dockerfile	Aplicativos que precisam de uma construção de imagem controlada e reproduzível	Manter o Dockerfile e as imagens base
Docker Compose	Aplicativos de múltiplos contêineres e projetos Compose existentes	Revisar redes, volumes, portas e dependências de serviço
Imagem Docker pré-construída	Software já publicado em um registro confiável	Fixar uma versão da imagem e verificar sua origem
Serviço de um clique	Ferramentas auto-hospedadas suportadas com um modelo Coolify	Revisar variáveis geradas, armazenamento e versões de imagem upstream

O Coolify executa aplicativos como contêineres Docker. Construir a fonte no mesmo VPS pode criar picos de CPU, memória e disco, especialmente para grandes dependências de JavaScript, compilação nativa ou builds Docker de múltiplas etapas. Se as builds tornarem o servidor não responsivo, aumente o tamanho do VPS ou use um servidor de construção separado em vez de assumir que o painel pode isolar trabalho ilimitado.

Fixe versões de imagens de aplicativos e bancos de dados onde for prático. Uma tag flutuante pode puxar uma versão materialmente diferente durante uma reimplantação rotineira, criando uma atualização que você não planejou.

Como você deve dimensionar um VPS Coolify?

Dimensione o VPS para o Coolify mais o uso máximo de recursos de cada build, aplicativo, banco de dados, fluxo de log, backup e imagem de contêiner armazenada no servidor. O mínimo do fluxo de compra é um limite de elegibilidade para uma carga de trabalho inicial pequena, não uma recomendação universal.

Padrão de carga de trabalho	Principal pressão	Orientação de planejamento
Um pequeno site estático	Construção de CPU e armazenamento de imagem	Mantenha espaço livre para reconstruções e atualizações
API sem um banco de dados local	Picos de memória e tráfego	Monitore o uso de memória do processo e o comportamento de reinicialização
Aplicativo web mais banco de dados	RAM, latência de disco e espaço de backup	Proteja os dados do banco de dados com armazenamento persistente e dumps nativos
Vários aplicativos	Memória agregada, logs e imagens	Meça picos combinados, não uso ocioso
Grandes builds de fonte	CPU, RAM, arquivos temporários e camadas de imagem	Considere um plano maior ou servidor de construção separado
Serviços com estado	Durabilidade do disco, crescimento e recuperação	Planeje retenção, backup fora do servidor e testes de restauração

Observe o espaço livre em disco tão de perto quanto a memória. Camadas de imagens Docker, caches de construção, histórico de implantação, logs, arquivos de banco de dados e backups podem crescer até que as implantações falhem ou os bancos de dados parem. A limpeza deve remover apenas artefatos que você entende; excluir um volume ativo não é manutenção rotineira.

Se uma carga de trabalho for crítica para os negócios, um VPS maior melhora a capacidade, mas não fornece alta disponibilidade. Backups externos, monitoramento, failover e um design de múltiplos servidores são requisitos separados. Uma implantação Uptime Kuma auto-hospedada pode fornecer um ponto de vista de monitoramento, mas não deve compartilhar todos os domínios de falha com o serviço que monitora.

O que você deve fazer backup?

Faça backup dos dados do plano de controle do Coolify e do estado de cada carga de trabalho implantada como camadas de recuperação separadas. O processo de backup oficial do Coolify protege as configurações do Coolify, mas não inclui automaticamente cada volume ou banco de dados de aplicativo.

Um plano de recuperação completo deve cobrir:

O backup do banco de dados do Coolify.
O APP_KEY do Coolify, armazenado com segurança fora do VPS.
Chaves SSH gerenciadas pelo Coolify necessárias para reconectar servidores gerenciados.
Dumps nativos de banco de dados para PostgreSQL, MySQL, MariaDB, MongoDB ou outros serviços com estado.
Volumes persistentes e arquivos de aplicativo montados por bind.
Repositórios Git, Dockerfiles, arquivos Compose e documentação de implantação.
Variáveis de ambiente e segredos através de um processo seguro e recuperável.
Registros DNS, propriedade de domínio, suposições de proxy e dependências de certificado.
Uma ordem de restauração testada em outro servidor.

Não armazene o único backup no mesmo VPS. Uma falha de disco, comprometimento de conta, exclusão acidental ou exclusão do VPS pode remover tanto a carga de trabalho ativa quanto uma cópia local.

O guia oficial de backup e restauração do Coolify observa explicitamente que um backup da instância do Coolify não faz backup dos dados do aplicativo, como montagens de volume. Teste a restauração com a mesma versão do Coolify usada para criar o backup, depois verifique projetos, credenciais, aplicativos, bancos de dados e domínios antes de considerar a recuperação bem-sucedida.

Como você deve atualizar o Coolify e os aplicativos implantados?

Atualize o Coolify e seus aplicativos deliberadamente, com um backup verificado e um plano de reversão para cada camada com estado. A imagem do VoyraCloud entrega uma versão fixa do Coolify e não atualiza continuamente sua instância.

Antes de uma atualização do Coolify:

Leia as notas de versão oficiais e as mudanças significativas.
Registre a versão atualmente em execução.
Faça backup do banco de dados do Coolify, APP_KEY, chaves SSH, aplicativos, bancos de dados e volumes.
Confirme espaço livre suficiente em disco para novas imagens e trabalho de migração.
Agende uma janela de manutenção.
Atualize para uma versão específica revisada em vez de um alvo flutuante não revisado.
Teste login, acessibilidade do servidor, uma construção, uma implantação, logs, terminal, domínios, HTTPS e recuperação de reinicialização.
Restaure em um sistema separado quando precisar provar a reversão, em vez de assumir que uma imagem de contêiner mais antiga é suficiente.

O Coolify suporta atualizações automáticas, semi-automáticas e manuais. Para uma instância de produção, atualizações manuais controladas ou semi-automáticas revisadas reduzem surpresas. O guia oficial de atualização também recomenda fazer backup antes de uma atualização.

As atualizações de aplicativos são separadas. Uma atualização do Coolify não atualiza todos os aplicativos de forma segura, e uma nova imagem de aplicativo pode incluir migrações de banco de dados que dificultam a reversão. Fixe versões, revise mudanças upstream, faça backup de dados, implante, teste e monitore cada carga de trabalho de acordo com seus próprios requisitos.

Erros comuns a evitar

Os erros mais sérios do Coolify envolvem exposição pública de gerenciamento, backups incompletos e tratar uma plataforma de implantação como infraestrutura ilimitada. Evite esses padrões:

Não exponha uma página de registro do Coolify não inicializada para a internet pública.
Não abra as portas 8000, 6001 ou 6002 como um atalho em torno do túnel SSH ou configuração de domínio.
Não assuma que o UFW sozinho bloqueia portas publicadas pelo Docker; verifique a acessibilidade a partir de uma rede externa.
Não coloque bancos de dados em portas públicas a menos que o acesso remoto seja necessário e seguro.
Não cometa segredos de ambiente no Git ou cole-os em logs de construção públicos.
Não use tags de contêiner flutuantes para serviços com estado importantes.
Não assuma que um início de contêiner bem-sucedido significa que um aplicativo está saudável.
Não trate o VPS mínimo elegível como suficiente para builds arbitrários ou múltiplos bancos de dados.
Não mantenha o único backup no mesmo VPS.
Não confunda um backup de banco de dados do Coolify com backups de volume de aplicativo ou banco de dados.
Não ative atualizações não supervisionadas sem entender migrações e reversões.
Não espere que um VPS forneça alta disponibilidade.

FAQ

O que significa auto-hospedar o Coolify em um VPS?

Significa executar a plataforma de implantação Coolify em um servidor Linux virtual que você controla. O Coolify gerencia builds, contêineres, domínios, serviços e fluxos de trabalho de implantação, enquanto você gerencia o VPS, aplicativos, dados, credenciais, atualizações, segurança, backups e capacidade.

Preciso instalar o Coolify manualmente?

Não, a imagem do aplicativo VoyraCloud entrega o Coolify pré-instalado. Crie um VPS elegível, copie o comando do túnel SSH da página de recursos, abra a URL do painel local e crie o primeiro administrador. Você ainda implanta e configura seus próprios aplicativos.

Por que o painel do Coolify não está disponível no IP público do servidor?

O painel inicial é acessado intencionalmente através de um túnel SSH porque o primeiro registro concede controle de alto privilégio. Mantenha o túnel fornecido aberto e visite http://127.0.0.1:8000. Mais tarde, você pode configurar seu próprio domínio de painel e HTTPS confiável através do proxy do Coolify.

Quais portas o Coolify precisa?

As portas públicas 80 e 443 suportam tráfego de aplicativos, validação de domínio e HTTPS, enquanto as portas de gerenciamento 8000, 6001 e 6002 permanecem locais na imagem do VoyraCloud. O SSH usa a porta mostrada para seu próprio VPS. Portas adicionais dependem dos aplicativos que você publica deliberadamente.

O Coolify fornece HTTPS automaticamente?

O Coolify pode configurar automaticamente seu proxy e solicitar um certificado Let’s Encrypt depois que você aponta um domínio para o VPS e insere um FQDN HTTPS. Um domínio não está incluído, o DNS deve resolver corretamente e as portas públicas 80 e 443 devem ser acessíveis. Um fallback autoassinado não é HTTPS confiável pelo navegador.

Posso implantar repositórios Git privados?

Sim, o Coolify suporta fluxos de trabalho de repositórios privados através de integrações Git suportadas e chaves de implantação. Use credenciais de menor privilégio, revise a exposição de webhook, gire chaves quando o acesso mudar e nunca armazene credenciais de repositório em logs ou código públicos.

O Coolify faz backup de cada aplicativo implantado?

Não, um backup da instância do Coolify não protege automaticamente cada banco de dados, volume ou arquivo de aplicativo. Faça backup do plano de controle do Coolify, bancos de dados de aplicativos, armazenamento persistente, configuração, segredos e documentação de recuperação separadamente, depois teste a restauração completa.

O VPS mínimo elegível é suficiente para vários aplicativos?

Não necessariamente. O mínimo suporta a plataforma Coolify e uma carga de trabalho inicial leve, enquanto a capacidade real depende do tamanho da build, memória do aplicativo, bancos de dados, logs, tráfego, backups e crescimento do armazenamento. Monitore o uso real e mude para uma configuração maior antes que a pressão dos recursos afete a confiabilidade.

O VoyraCloud atualiza o Coolify para mim?

Não, o Coolify é auto-gerenciado após a entrega do VPS. Mantenha atualizações automáticas controladas, revise notas de versão upstream, faça backup de todos os dados necessários e atualize para uma versão específica testada. Atualizações de sistema operacional e de aplicativos permanecem responsabilidades separadas.

O Coolify pode tornar um VPS altamente disponível?

Não, um VPS Coolify permanece um domínio de falha. Um servidor maior pode fornecer mais capacidade, mas alta disponibilidade requer servidores separados, balanceamento de carga, estado replicado onde apropriado, monitoramento independente, backups externos e failover testado.

Conclusão

Auto-hospede o Coolify em um VPS quando você quiser automação de implantação orientada a aplicativos sem abrir mão do controle do servidor subjacente. A imagem do aplicativo VoyraCloud fornece um ambiente de início testado e um caminho de primeiro acesso privado, enquanto o Coolify fornece fluxos de trabalho de Git, Docker, domínio, HTTPS, banco de dados e serviço.

Comece com o túnel SSH, crie o primeiro administrador, implante um pequeno aplicativo e valide um domínio real com HTTPS confiável. Em seguida, adicione cargas de trabalho gradualmente, meça o uso de recursos, fixe versões, proteja segredos, faça backup de cada camada com estado e teste a recuperação antes que o servidor se torne crítico.

Para um fluxo de trabalho de gerenciamento de contêiner de nível inferior, compare esta abordagem com executar Docker e Portainer em um VPS.

Explore a imagem do aplicativo VoyraCloud Coolify para começar a partir do ambiente pré-instalado.