Registre a forma de instalação, o banco e as variáveis de ambiente
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.
