Hospedagem Segura — página inicial

Bancos e serviços

Como instalar o n8n no Coolify

O modelo certo do catálogo, o banco PostgreSQL pronto, o fuso de Brasília, o domínio, o e-mail e como atualizar.

  • Nível: Iniciante
  • Tempo: cerca de 15 minutos
  • Atualizado em 17/11/2026
  • Por equipe técnica da Hospedagem Segura

Conteúdo do tutorial

Resposta rápida

Para instalar o n8n no Coolify, abra o ambiente do projeto, clique em New Resource, busque n8n e escolha o modelo N8N With Postgresql: o Coolify cria o n8n com um banco PostgreSQL, usuário e senha gerados. Troque as variáveis GENERIC_TIMEZONE e TZ para America/Sao_Paulo, ponha o seu domínio em Domains e clique em Deploy. Com o serviço Running, abra o endereço e crie a conta de dono do n8n.

Vídeo: Como instalar o n8n no Coolify (com PostgreSQL e fuso de Brasília)2 min 53 s, narrado e com legendaAssistir no YouTube

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

  • Escolher entre os três modelos do n8n no catálogo do Coolify
  • Criar o n8n com o banco PostgreSQL já configurado
  • Acertar o fuso horário para os agendamentos rodarem no horário de Brasília
  • Ligar o seu domínio, publicar e criar a conta de dono do n8n
  • Configurar o e-mail do n8n e atualizar a versão com segurança

Antes de começar

  • O Coolify instalado e o primeiro acesso feito (como instalar o Coolify)
  • Um projeto com o ambiente onde o n8n vai ficar (projetos e ambientes)
  • Um subdomínio para o n8n, como n8n.suaempresa.com.br, apontado para o IPv4 da VPS
Neste tutorial
  1. Qual modelo do n8n escolher?
  2. Crie o serviço do n8n
  3. Acerte o fuso horário de Brasília
  4. Ligue o seu domínio
  5. Publique e crie a conta de dono
  6. Configure o e-mail do n8n
  7. Atualize o n8n
  8. Problemas comuns
  9. Perguntas frequentes

Qual modelo do n8n escolher?

O catálogo do Coolify tem três modelos prontos do n8n, a ferramenta de automação de fluxos de trabalho. A diferença está no banco de dados e em como as execuções rodam.

Os modelos do n8n no catálogo do Coolify 4.7.5
ModeloBanco de dadosQuando usar
N8NSQLite, dentro do próprio contêinerTestes e uso leve
N8N With PostgresqlPostgreSQL 16, num contêiner à parteUso de verdade: o indicado para a maioria
N8N With Postgres And WorkerPostgreSQL e Redis, com um contêiner de workerMuitas execuções ao mesmo tempo, em fila

Este tutorial usa o N8N With Postgresql, que a documentação do Coolify indica para produção. Os fluxos, as credenciais e o histórico de execuções ficam no banco, e não num arquivo dentro do contêiner.

Crie o serviço do n8n

  1. Busque o n8n no catálogo

    No painel: ProjectsLoja VirtualproductionNew Resource(Projetos › o seu projeto › o ambiente › novo recurso)

    Em New Resource, digite n8n na busca (1). Aparecem os três modelos. Clique no N8N With Postgresql (2) ou no botão Configure (configurar) ao lado dele.

    1. A busca do catálogo
    2. O modelo N8N With Postgresql
  2. Confira o serviço criado

    O Coolify cria o serviço a partir do modelo. Dê um nome fácil, como n8n, e clique em Save changes. Em Service configuration (1), o usuário e a senha do PostgreSQL já foram gerados: não precisa criar o banco. Em Compose resources (2) ficam os contêineres: o n8n, os executores de código (task-runners) e o postgresql. O Deploy (3) fica para depois do fuso e do domínio.

    1. Service configuration: o banco já configurado
    2. Compose resources: os contêineres do serviço
    3. O botão Deploy

Acerte o fuso horário de Brasília

O modelo do Coolify vem com o fuso UTC. Nesse fuso, um fluxo agendado para as 8h roda às 5h no horário de Brasília. O n8n usa a variável GENERIC_TIMEZONE nos nós de agendamento (Schedule e Cron), e a TZ acerta o relógio do contêiner.

  1. Troque GENERIC_TIMEZONE e TZ

    No painel: n8nEnvironment Variables(o serviço › variáveis de ambiente)

    Clique em GENERIC_TIMEZONE. O valor (Value) vem escondido: clique no olho para ver. Troque por America/Sao_Paulo (1) e clique em Update Variable (2), que salva a variável. Faça o mesmo na TZ. A janela mostra o padrão do modelo: Compose default: UTC.

    1. O valor do fuso: America/Sao_Paulo
    2. Update Variable: salva a variável

Ligue o seu domínio

O Coolify gera um endereço provisório para o n8n. No serviço, abra Domains, troque esse endereço pelo seu subdomínio, como https://n8n.suaempresa.com.br, e faça o deploy. O modelo usa esse endereço também no link dos webhooks (WEBHOOK_URL) e no editor, então troque o domínio antes de criar fluxos com webhook. O passo a passo do DNS e do HTTPS está em domínios e SSL.

O endereço do n8n em Domains, com o redirecionamento de HTTP para HTTPS ligado.

Publique e crie a conta de dono

  1. Clique em Deploy

    Na primeira vez, o Coolify baixa as imagens do n8n e do PostgreSQL. Quando o serviço aparece como Running (rodando), abra o menu Links e clique no endereço.

  2. Crie a conta de dono do n8n

    O n8n abre a criação da conta de dono (owner), a de quem administra o n8n. Faça isso logo depois do deploy: até essa conta existir, quem abrir o endereço pode criá-la. Use um e-mail seu e uma senha forte.

Configure o e-mail do n8n

O n8n manda e-mail para convidar pessoas e redefinir senhas. Configure o SMTP com as variáveis abaixo, em Environment Variables, pelo botão Add (adicionar), e faça o deploy de novo.

Variáveis de SMTP do n8n (documentação do n8n)
VariávelO que pôr
N8N_EMAIL_MODEsmtp
N8N_SMTP_HOSTo servidor de envio do seu e-mail
N8N_SMTP_PORT587 ou 465
N8N_SMTP_USERo usuário da conta de e-mail
N8N_SMTP_PASSa senha da conta de e-mail
N8N_SMTP_SENDERo remetente, como n8n@suaempresa.com.br
N8N_SMTP_SSLtrue na porta 465; false na 587, que usa STARTTLS

A porta 25 de saída é bloqueada

Na VPS da Hospedagem Segura, a porta 25 de saída vem bloqueada. Use a porta 587 ou a 465 do seu provedor de e-mail. A senha do SMTP fica só nas variáveis do serviço: nunca no fluxo nem no repositório.

Atualize o n8n

O modelo fixa a versão do n8n na tag da imagem. Para atualizar, clique em Edit Compose File (editar o arquivo Compose) e troque a tag nas duas imagens, a do n8n e a dos executores, para a mesma versão nova. Salve, confira as variáveis e faça o deploy.

image: n8nio/n8n:2.10.2
...
image: n8nio/runners:2.10.2
As duas linhas de imagem no Compose do serviço. Troque a versão nas duas, igual.

Antes de atualizar

Leia as notas da versão nova do n8n e faça uma cópia dos dados antes. Os fluxos e as credenciais ficam no banco PostgreSQL do serviço, e a chave que cifra as credenciais, que o n8n cria no primeiro início, fica no volume do n8n (a pasta .n8n): guarde os dois. Veja volumes e tarefas agendadas. O Coolify não aplica sozinho, num serviço já criado, as mudanças que o modelo do catálogo recebe depois.

Como saber se deu certo

O serviço n8n aparece como Running, o seu domínio abre o n8n com HTTPS, a conta de dono foi criada e os agendamentos usam o horário de Brasília.

Problemas comuns

Os fluxos agendados rodam três horas antes ou depois
Causa provável
O n8n está no fuso UTC, o padrão do modelo do Coolify.
O que fazer
Troque GENERIC_TIMEZONE e TZ para America/Sao_Paulo em Environment Variables e faça o deploy de novo.
O link dos webhooks mostra o endereço provisório
Causa provável
O domínio do n8n foi trocado depois, ou ainda não foi trocado em Domains.
O que fazer
Ponha o seu domínio em Domains, faça o deploy de novo e confira o link do webhook no nó do fluxo.
O serviço não fica Running ou o n8n reinicia sozinho
Causa provável
Falta memória na VPS, ou o banco ainda não terminou de subir.
O que fazer
Veja os logs do contêiner do n8n e do postgresql e o consumo da VPS, como em logs, terminal e monitoramento. Pare o que não usa ou passe para um plano com mais memória.
O n8n não manda e-mail
Causa provável
O SMTP não foi configurado ou usa a porta 25, bloqueada na VPS.
O que fazer
Configure as variáveis N8N_SMTP_* com a porta 587 ou 465 e faça o deploy de novo.

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

Perguntas frequentes

Qual modelo do n8n escolher no Coolify?

Escolha o N8N With Postgresql para uso de verdade: o n8n guarda os fluxos e as credenciais num banco PostgreSQL à parte. O N8N simples usa SQLite e serve para testes; o N8N With Postgres And Worker separa as execuções em fila, para muito volume.

Por que o n8n no Coolify mostra o horário errado?

Porque o modelo do Coolify vem com o fuso UTC. Troque as variáveis GENERIC_TIMEZONE e TZ para America/Sao_Paulo em Environment Variables e faça o deploy de novo: os agendamentos passam a usar o horário de Brasília.

Como configurar o e-mail do n8n no Coolify?

Adicione as variáveis N8N_SMTP_HOST, N8N_SMTP_PORT, N8N_SMTP_USER, N8N_SMTP_PASS e N8N_SMTP_SENDER no serviço, com a porta 587 ou 465, e faça o deploy. Na VPS da Hospedagem Segura, a porta 25 de saída é bloqueada.

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

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.

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.