Publicar aplicações

Como publicar uma aplicação pelo Git no Coolify

Do 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.

Nível: Iniciante
Tempo: cerca de 10 minutos, mais o tempo do build
Atualizado em 12/11/2026
Por equipe técnica da Hospedagem Segura

Resposta rápida

Para publicar uma aplicação pelo Git no Coolify, abra o ambiente do projeto, clique em New Resource, escolha Public Git Repository, cole o endereço do repositório e clique em Check Repository. Confira o build pack (o Railpack detecta a linguagem sozinho), a porta e a pasta da aplicação, clique em Continue e depois em Deploy. O Coolify baixa o código, monta a imagem e coloca a aplicação no ar, num endereço provisório que você troca depois pelo seu domínio.

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

Criar uma aplicação a partir de um repositório Git público
Conferir o build pack, a porta e a pasta da aplicação antes do primeiro deploy
Acompanhar o deploy pelo log e saber quando ele terminou
Abrir a aplicação no endereço provisório que o Coolify gera

Antes de começar

O Coolify instalado na sua VPS e o primeiro acesso feito (veja como)
Um projeto criado (projetos e ambientes)
O endereço do repositório no GitHub, GitLab, Bitbucket ou outro Git. Repositório privado tem um caminho próprio: repositório privado

Neste guia

Como o deploy pelo Git funciona
Crie a aplicação a partir do repositório
Acompanhe o deploy pelo log
Abra a aplicação no endereço provisório
Problemas comuns

Como o deploy pelo Git funciona

Repositório Gito código da aplicação, no GitHub, GitLab ou outro Git
Buildo Coolify baixa o código e monta a imagem (Railpack, Dockerfile ou Compose)
Contêinera imagem nova roda na VPS; a antiga só sai quando a nova está de pé
Proxy e HTTPSo proxy entrega o domínio à aplicação e cuida do certificado

Do repositório ao endereço público, tudo dentro da sua VPS

O build roda na própria VPS, junto com as aplicações. Por isso a memória conta: um build de Node.js, de PHP com Composer ou de um site com muitas dependências usa bem mais memória do que a aplicação parada.

Crie a aplicação a partir do repositório

Clique em New Resource
No painel: ProjectsLoja Virtualproduction(Projetos › o seu projeto › o ambiente)
Abra o projeto, entre no ambiente onde a aplicação vai rodar e clique em New Resource (novo recurso), no alto da página.
Escolha Public Git Repository
A lista mostra tudo o que dá para publicar. No grupo Applications (aplicações), clique em Public Git Repository (repositório Git público).
Dica Os outros itens do grupo são para repositório privado (deploy key ou integração com GitHub, GitLab e Gitea), Dockerfile, Docker Compose e imagem Docker pronta. Veja os build packs.
Cole o endereço do repositório e clique em Check Repository
Em Repository URL, cole o endereço do repositório, como ele aparece no navegador. Check Repository (conferir repositório) lê o repositório e descobre o branch principal.
1. Endereço do repositório (Repository URL).
2. Botão Check Repository.
Dica Para publicar outro branch, use o endereço da árvore do branch, como https://github.com/empresa/projeto/tree/homologacao.
Confira o build e clique em Continue
O Coolify sugere a configuração. Confira cada campo antes de continuar, porque a maioria dos deploys que falham nasce aqui: porta errada ou pasta errada.
1. Branch: O branch que será publicado (aqui, main).
2. Build pack: Railpack, o padrão, que detecta a linguagem sozinho.O Nixpacks aparece como deprecated (obsoleto).
3. Port: A porta em que a sua aplicação escuta dentro do contêiner (aqui, 3000).
4. Base directory: A pasta da aplicação dentro do repositório. Deixe / se ela está na raiz.
5. Continue: Cria a aplicação com essa configuração. Ainda não publica.
Dê um nome e clique em Deploy
A aplicação nasce com um nome automático. Troque por um nome que você reconheça, salve e clique em Deploy (publicar), no alto da página.
1. Nome da aplicação (Name). Depois de mudar, salve com Save changes.
2. Botão Deploy, que inicia o primeiro deploy.

A porta precisa bater com a da aplicação

O Coolify entrega o tráfego na porta informada em Port. Se a sua aplicação escuta em outra porta, ou só em 127.0.0.1, o domínio responde com erro 502 ou No available server. A aplicação precisa escutar em 0.0.0.0.

Acompanhe o deploy pelo log

Veja o log ao vivo
O Coolify abre o histórico de deploys. Enquanto o status mostra In Progress (em andamento), o log mostra o código sendo baixado do repositório e a imagem sendo montada.
Espere o status Finished
Quando o deploy termina, o status vira Finished (concluído) e a aplicação aparece como Running (rodando) no alto da página.
Confira o fim do log
As últimas linhas contam a troca: o contêiner novo sobe, o antigo sai e o log registra Rolling update completed. No primeiro deploy não há contêiner antigo, mas as linhas são as mesmas.

Quer entender o rolling update?

No rolling update, o Coolify sobe o contêiner novo e só tira o antigo quando o novo está de pé. A aplicação continua respondendo durante a troca na maioria dos casos. A própria documentação do Coolify avisa que isso não garante zero queda: aplicações com Docker Compose, com porta publicada direto no servidor ou com nome de contêiner fixo trocam de uma vez.

Abra a aplicação no endereço provisório

Abra o menu Links
No alto da página da aplicação, Links mostra os endereços em que ela responde. Clique no endereço para abrir.
Confira a resposta
A aplicação de exemplo responde com uma mensagem curta. A sua vai mostrar a página inicial dela. Esse endereço é provisório: o próximo passo é trocar pelo seu domínio, com HTTPS.

Endereço provisório

Sem domínio configurado no servidor, o Coolify gera um endereço terminado em sslip.io, com o IP da sua VPS. Ele serve para testar, sem HTTPS. Para o site de verdade, use o seu domínio.

Como saber se deu certo

O deploy aparece como Finished no histórico, a aplicação fica Running no alto da página e o endereço do menu Links abre a sua aplicação.

Problemas comuns

O deploy falhou logo no começo, ao baixar o código

Causa provável: Endereço do repositório errado, branch que não existe ou repositório privado usado como público.
O que fazer: Confira o endereço e o branch em Git Source. Repositório privado precisa de deploy key ou de integração: veja repositório privado.

O build falha com erro de memória ou o servidor fica lento

Causa provável: O build disputa memória com as aplicações e os bancos que já rodam na VPS.
O que fazer: Veja o consumo nas métricas do servidor. Reduza o que roda junto ou passe para um plano com mais memória. Se o projeto tem build muito pesado, monte a imagem fora da VPS (por exemplo, numa esteira de CI) e publique com Docker Image.

O deploy termina como Finished, mas o endereço mostra 502 ou No available server

Causa provável: A porta em Port não é a porta em que a aplicação escuta, ou a aplicação escuta só em 127.0.0.1.
O que fazer: Ajuste a porta na página da aplicação, faça a aplicação escutar em 0.0.0.0 e clique em Redeploy. Veja os detalhes em problemas comuns.

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

Próximo passoComo 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.

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