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.
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
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.
| Modelo | Banco de dados | Quando usar |
|---|---|---|
| N8N | SQLite, dentro do próprio contêiner | Testes e uso leve |
| N8N With Postgresql | PostgreSQL 16, num contêiner à parte | Uso de verdade: o indicado para a maioria |
| N8N With Postgres And Worker | PostgreSQL e Redis, com um contêiner de worker | Muitas 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
Busque o n8n no catálogo
No painel:
Em New Resource, digite
n8nna busca (1). Aparecem os três modelos. Clique no N8N With Postgresql (2) ou no botão Configure (configurar) ao lado dele.- 1A busca do catálogo
- 2O modelo N8N With Postgresql
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.- 1Service configuration: o banco já configurado
- 2Compose resources: os contêineres do serviço
- 3O 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.
Troque GENERIC_TIMEZONE e TZ
No painel:
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.- 1O valor do fuso: America/Sao_Paulo
- 2Update 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
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.
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ável | O que pôr |
|---|---|
| N8N_EMAIL_MODE | smtp |
| N8N_SMTP_HOST | o servidor de envio do seu e-mail |
| N8N_SMTP_PORT | 587 ou 465 |
| N8N_SMTP_USER | o usuário da conta de e-mail |
| N8N_SMTP_PASS | a senha da conta de e-mail |
| N8N_SMTP_SENDER | o remetente, como n8n@suaempresa.com.br |
| N8N_SMTP_SSL | true na porta 465; false na 587, que usa STARTTLS |
A porta 25 de saída é bloqueada
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.2Antes de atualizar
.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_TIMEZONEeTZparaAmerica/Sao_Pauloem 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.
Fontes e documentação oficial
- Coolify: n8n
- Coolify: atualizar um serviço
- n8n: variáveis de e-mail (SMTP)
- n8n: fuso horário
- n8n: chave de criptografia
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
- 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
- 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
- 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
Para entender melhor
- Artigo · VPS, Docker e CoolifySenha do administrador do Joomla: como fazer o reset pelo banco ou pela CLINo Joomla, o Superusuário não recebe o link de redefinição por e-mail, mesmo com a mensagem de envio na tela. Para recuperar o acesso, troque a senha direto no banco pelo phpMyAdmin ou use a CLI do próprio Joomla. Os dois caminhos foram testados no Joomla 6.1.4 e valem para o 5.Para entender
- Artigo · VPS, Docker e CoolifyComo instalar Docker e Docker Compose no Ubuntu ServerO jeito recomendado de instalar o Docker em um servidor Ubuntu é pelo repositório oficial da Docker, que já traz o plugin do Compose. Veja o passo a passo e os cuidados de segurança.Para entender
- Artigo · VPS, Docker e CoolifyComo instalar Node.js no servidor Linux e manter a aplicação no arInstalar o Node.js é a parte fácil. Para uma aplicação em produção, você também precisa de um gerenciador de processos e de um proxy reverso. Veja o caminho completo no Ubuntu.Para entender
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.