Ir para o conteúdo
Promovaweb

Registre a forma de instalação, o banco e as variáveis de ambiente

Revisado em

Antes de começar

Ter, em um único documento, a forma de instalação, o banco, os volumes e as variáveis de ambiente que a v3 altera na sua instância.

  • Acesso ao servidor ou ao arquivo do Docker Compose ou da stack.
  • Usuário owner ou admin no n8n.

O relatório de migração mostra os ajustes de instância que ele detecta. Algumas mudanças, porém, dependem de como o servidor foi montado. Este registro cobre essa parte e serve de base para o backup e para o ambiente de testes.

1. Como o n8n roda

Anote uma destas formas: npm ou npx n8n, docker run, Docker Compose, Docker Swarm, Kubernetes ou Helm. Na v3, a instalação self-hosted exige Docker. Instalações por npm precisam mudar antes da atualização. O tutorial da etapa Migrar cobre esse caso. Kubernetes e Helm não são afetados por essa exigência, segundo o anúncio oficial.

Registre também a versão atual, que aparece em Settings ou na tag da imagem.

2. Qual banco a instância usa

SQLite fica dentro da pasta .n8n. Postgres fica em outro serviço e precisa de backup próprio. Anote host, nome do banco e versão do Postgres.

3. Onde ficam os volumes

Registre o volume montado em /home/node/.n8n e qualquer outro caminho montado. A v3 renomeia ~/.n8n/binaryData para ~/.n8n/storage no primeiro início e não sobe se as duas pastas existirem. Uma instalação com volume montado em binaryData precisa de ajuste.

4. Variáveis que a v3 altera

Confira se a sua instância define alguma destas variáveis e qual valor usa:

Variável Mudança na v3
N8N_DEFAULT_BINARY_DATA_MODE O valor default (em memória) deixa de existir
N8N_RUNNERS_TASK_TIMEOUT O padrão cai de 300 para 60 segundos
N8N_UNVERIFIED_PACKAGES_ENABLED O padrão vira false
OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS Removida. Execuções manuais vão para os workers no queue mode
N8N_PRE_EXECUTE_ERROR_CREATES_EXECUTION Removida
N8N_MIGRATE_FS_STORAGE_PATH Removida
N8N_SSRF_BLOCKED_IP_RANGES A lista default ganha quatro faixas
N8N_COMPRESSION_NODE_MAX_DECOMPRESSED_SIZE_BYTES O padrão cai de 2 GiB para 256 MiB

5. O que o relatório mostra

Abra Settings > Migration Report na aba Instance issues. Copie os itens para o mesmo documento. Junte o CSV exportado no tutorial anterior.

Confira o resultado

O documento responde a cinco perguntas: como o n8n roda, qual banco usa, onde ficam os volumes, quais variáveis da lista estão definidas e o que o relatório de migração mostra na aba Instance issues.

Fontes e conferência

Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.