Build packs no Coolify: Railpack, Dockerfile, Compose e imagem pronta

Os build packs lado a lado

Build pack é a receita que o Coolify usa para montar a imagem da aplicação. Você escolhe ao criar a aplicação e pode trocar depois.

Na dúvida, comece pelo Railpack. Se o build falhar por algo que ele não detecta, passe para Dockerfile.

Railpack: o padrão

O Railpack lê o repositório, descobre a linguagem e o framework e monta a imagem com o BuildKit do Docker. Na maioria dos projetos, basta conferir a porta e a pasta.

1. Confira o build pack ao criar a aplicação

   Depois de Check Repository, o formulário mostra o que o Coolify detectou. Confira cada campo antes de continuar.

   painel.example.com/project/…/new12345Toque para ampliar

   12345

   Fechar

   1. 1Branch: O branch que será publicado (aqui, main).
   2. 2Build pack: Railpack vem marcado. Troque aqui se o projeto pede outro build pack.
   3. 3Port: 3000 nas aplicações Git. Troque pela porta em que a sua aplicação escuta.
   4. 4Base directory: A pasta da aplicação no repositório. / quando ela está na raiz.
   5. 5Continue: Cria a aplicação. O build só começa no Deploy.

2. Troque o build pack de uma aplicação existente

   No painel: site-da-loja(a sua aplicação)

   Na página da aplicação, a lista Build strategy (estratégia de build) mostra Railpack, Nixpacks (deprecated), Static, Dockerfile e Compose. Depois de trocar, salve as alterações e clique em Redeploy (publicar de novo).

   painel.example.com/project/…/application/…Toque para ampliar

   

   Fechar

   Dica O Railpack aceita ajustes num arquivo railpack.json no repositório e em variáveis que começam com RAILPACK_. Veja variáveis de ambiente.

Dockerfile: controle total da imagem

Com Dockerfile, você decide a imagem base, as dependências e o comando de início. O Coolify usa o Dockerfile do repositório (build pack Dockerfile) ou um Dockerfile escrito direto no painel, sem Git. A porta vem do primeiro EXPOSE; sem EXPOSE, ela é 80.

FROM node:22-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
EXPOSE 3000
CMD ["node", "server.js"]

1. Ou escreva o Dockerfile no painel

   No painel: New Resource›Dockerfile(Novo recurso › Dockerfile)

   No ambiente do projeto, clique em New Resource e escolha Dockerfile. Escreva o conteúdo no editor e clique em Create Application (criar aplicação). Sem Git, não há arquivos do repositório para copiar.

   painel.example.com/project/…/newToque para ampliar

   

   Fechar

Docker Compose: vários serviços juntos

Com Docker Compose, o Coolify sobe todos os serviços do arquivo Compose do repositório, numa rede própria. É o caminho para web, fila e cache que sobem juntos.

• O domínio é ligado por serviço. A porta no domínio, como https://loja.example.com:3000, indica a porta dentro do contêiner e não abre porta na VPS.
• Health check e volumes ficam no próprio arquivo Compose.
• Não há rolling update: os contêineres são trocados de uma vez.

Docker Image: imagem pronta

Docker Image pula o build: o Coolify só baixa a imagem de um registro, como o Docker Hub. É a saída para build pesado: a imagem é montada fora da VPS, numa esteira de CI, e a VPS só roda.

1. Informe a imagem e a versão

   No painel: New Resource›Docker Image(Novo recurso › Imagem Docker)

   No ambiente do projeto, clique em New Resource e escolha Docker Image.

   painel.example.com/project/…/new123Toque para ampliar

   123

   Fechar

   1. 1Image name: O endereço da imagem no registro, como registry.example.com/minha-empresa/loja.
   2. 2Tag: A versão da imagem, como 1.4.2. Em branco, o Coolify usa latest.Use a tag ou o SHA256 digest, nunca os dois.
   3. 3Create Application: Cria a aplicação. A porta padrão é 80: troque se a imagem escuta em outra.