flowtemplates

n8n · auto-hospedagem · verificado em 6 de setembro de 2026

Guia do n8n auto-hospedado

A instalação cabe em uma linha — curl -fsSL https://get.n8n.io | sh —, mas a decisão não. Auto-hospedar o n8n elimina a mensalidade em euro e devolve o controle de onde os dados ficam; em troca, você assume servidor, atualização e segurança. Sem chave de licença, o que roda é a Community Edition gratuita: a documentação diz literalmente «All self-hosted installations use the same core product. Without a license key, n8n runs as the free Community edition.»

Duas armadilhas específicas de quem opera no Brasil aparecem logo no primeiro dia: o fuso horário padrão de uma instância auto-hospedada é America/New_York, então um fluxo agendado «às 9h» dispara na hora errada; e o editor recusa abrir por http:// em um IP de rede local por causa do cookie seguro. As duas têm correção de um minuto e estão abaixo, junto com os comandos literais, o procedimento de atualização e a conta de custo comparada ao n8n Cloud.

O custo real, antes dos comandos

A licença é gratuita, mas o total não é zero. O que você paga é: uma VPS que aguente o volume, o tempo de instalar e configurar, e o tempo recorrente de atualizar e monitorar. A própria n8n lista essas obrigações — instalar e configurar servidores e contêineres, gerenciar recursos e escala, proteger servidores e aplicações e configurar o n8n — e acrescenta que recomenda a auto-hospedagem para usuários experientes, porque erros podem levar a perda de dados, problemas de segurança e indisponibilidade.

Do outro lado da conta, o n8n Cloud custa 20 € por mês no Starter (2.500 execuções) e 50 € no Pro (10.000), na cobrança anual — valores em euro, convertidos pela cotação do dia da cobrança. Abaixo de 10.000 execuções mensais, essa assinatura costuma sair mais barata do que algumas horas de manutenção por mês. Acima disso, o servidor próprio ganha com folga, porque na nuvem do n8n o degrau seguinte é o Enterprise sob consulta. As contas completas estão em preços do n8n.

Há ainda um motivo que não depende de volume: manter os dados de execução na sua própria infraestrutura. É o argumento que costuma decidir a questão em times que tratam dados sensíveis — e independe de quantas execuções você faz por mês.

Os comandos, na íntegra

Copiados sem alteração da documentação do n8n. Troque os marcadores entre sinais de menor e maior pelos seus valores.

Instalação em uma linha. Exige Docker no Linux ou macOS (no Windows, via WSL) e o plugin docker compose versão 2 — não o binário antigo docker-compose. Ao final, o script mostra onde ficam os dados (./n8n, volume n8n-data) e como parar, atualizar e desinstalar.

curl -fsSL https://get.n8n.io | sh

Contêiner Docker com dados persistentes. Cria o volume, baixa a imagem e sobe o contêiner: publica a porta 5678, define o fuso duas vezes (TZ para o sistema e GENERIC_TIMEZONE para nós agendados como o Schedule Trigger), força permissões seguras no arquivo de configuração e liga os task runners, que a documentação descreve como a forma recomendada de executar tarefas.

docker volume create n8n_data

docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" \
 -e TZ="<YOUR_TIMEZONE>" \
 -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
 -e N8N_RUNNERS_ENABLED=true \
 -v n8n_data:/home/node/.n8n \
 n8nio/n8n

Três ajustes para fazer antes de criar qualquer fluxo

  • Fuso horárioO padrão em auto-hospedagem é America/New_York, conforme a documentação. Defina GENERIC_TIMEZONE e TZ como America/Sao_Paulo (ou America/Manaus, America/Belem, conforme a região). Para conferir em que horário a sua programação cai de fato, use o nosso construtor de expressões cron, que permite escolher o fuso.
  • Cookie seguroO n8n marca o cookie de sessão como Secure. Abrindo o editor por http:// em um IP da rede local, aparece uma página de aviso no lugar da interface. As causas e as três saídas estão em erro de cookie seguro.
  • Persistência dos dadosSem volume, tudo se perde quando o contêiner é recriado. Por isso o comando acima cria n8n_data e monta em /home/node/.n8n. Na instalação de uma linha, o script já cuida disso.

Como atualizar

O que se atualiza é a imagem, então o procedimento depende de como você instalou.

Docker Compose, a partir da pasta onde está o seu arquivo compose:

cd </path/to/your/compose/file/directory>
docker compose pull
docker compose down
docker compose up -d

Instalação em uma linha — é exatamente o comando que o script imprime ao terminar:

curl -fsSL https://get.n8n.io | sh -s -- --upgrade

Faça backup antes de um salto grande de versão. Os dados ficam no volume, não no contêiner.

Formas de instalar, segundo a documentação

MétodoPara que o n8n recomendaRequisitos
Uma linhasubir rápido com configuração mínimaLinux ou macOS com curl; plugin docker compose v2
Docker Composeprodução, com banco de dados e serviços adicionaisDocker e Docker Compose
Docker (contêiner avulso)controle fino sem arquivo composeDocker
Provedores de nuvemAWS, Azure, Google Cloud (Cloud Run ou GKE), DigitalOcean, Hetzner, Heroku, OpenShift — cada um com guia próprioconta no provedor
npmdesenvolvimento local ou testesNode.js — marcado como obsoleto a partir do n8n 3.0; a documentação indica Docker Compose ou a instalação de uma linha

Depois de instalar: importe um modelo e rode uma vez

A prova mais rápida de que a instância está de pé é um fluxo pronto que não precisa de credencial nenhuma.

  1. Escolha um modeloVários fluxos da nossa biblioteca de n8n não pedem credencial — o leitor de RSS e a chamada de API, por exemplo.
  2. Importe o JSONCole na área de trabalho vazia ou use ⋯ → «Import from File…». O passo a passo está em importar modelos do n8n.
  3. Execute uma vezCom «Execute Workflow». Se tudo ficar verde, rede do Docker, volume e fuso estão corretos.
  4. Publique e confiraWebhooks de produção só são registrados depois que o fluxo é publicado. Se a chamada responder 404, veja «webhook não registrado»; se a falha for na importação, «não foi possível importar o arquivo».

Fontes e data da verificação

Todos os comandos e informações desta página vêm da documentação do n8n, lida em 6 de setembro de 2026; os comandos estão reproduzidos sem alteração. Se a documentação e esta página divergirem, vale a documentação — avise em support@flowtemplates.app.

Perguntas frequentes

Como auto-hospedar o n8n?

O caminho mais rápido é o comando de uma linha documentado pelo n8n: curl -fsSL https://get.n8n.io | sh. Ele exige Docker no Linux ou macOS (no Windows, via WSL) e o plugin docker compose v2, e deixa o n8n em http://localhost:5678. Para produção, o n8n recomenda Docker Compose, porque permite subir um banco de dados e outros serviços ao lado.

O n8n auto-hospedado é gratuito?

É. Sem chave de licença, qualquer instalação própria roda como Community Edition gratuita, que segundo a documentação traz quase todos os recursos. O que custa é o servidor e o seu tempo. Chaves Business e Enterprise liberam recursos extras, mas não são necessárias para operar.

O que falta na Community Edition?

Uma lista fechada: variáveis personalizadas, ambientes, segredos externos, armazenamento externo de dados binários, streaming de logs, modo multi-main, projetos, SSO (SAML, LDAP), compartilhamento de fluxos e credenciais, e controle de versão com Git. Todo o resto — todos os nós, todas as integrações e fluxos ilimitados — está incluído.

Por que meu fluxo agendado dispara no horário errado?

Porque o fuso horário padrão de uma instância auto-hospedada é America/New_York, conforme a documentação do n8n. Defina GENERIC_TIMEZONE como America/Sao_Paulo (ou o fuso da sua região) e defina TZ junto, para que scripts e comandos dentro do contêiner enxerguem o mesmo horário. Cada fluxo ainda pode ter o próprio fuso nas configurações do fluxo.

Como atualizo uma instância auto-hospedada?

Com Docker Compose: entre na pasta do arquivo compose e rode docker compose pull, docker compose down e docker compose up -d. Se instalou com o comando de uma linha, use curl -fsSL https://get.n8n.io | sh -s -- --upgrade, que é exatamente o comando impresso pelo script ao final da instalação.

Compensa auto-hospedar em vez de pagar o n8n Cloud?

Abaixo de cerca de 10.000 execuções por mês, normalmente não: 20 € no Starter e 50 € no Pro custam menos do que algumas horas de manutenção. Acima disso, sim, porque na nuvem do n8n o degrau seguinte é o Enterprise sob consulta. O outro motivo, que independe do volume, é manter os dados na sua própria infraestrutura — o n8n documenta instalações em AWS, Azure, Google Cloud, DigitalOcean, Hetzner e outros.