Migração para o n8n 3.0
O n8n 3.0 saiu como pre-release em 27 de outubro de 2026, com lançamento oficial previsto para o início de dezembro. A versão remove caminhos antigos, deixa padrões de segurança mais rígidos e muda parte do funcionamento interno. Esta série leva sua instalação da 2.x para a 3.0 em sete etapas.
O que você precisa saber antes
- Não tem volta. Depois da atualização, só o backup devolve a versão 2.x.
- Só Docker. Instalações self-hosted por npm precisam mudar antes.
- Relatório de migração. A partir da 2.39, Settings > Migration Report lista o que precisa de ajuste na sua instância.
- Da 1.x, passe pela 2.x. Não existe caminho direto da 1.x para a 3.0.
As sete etapas
- Entender o que muda.
- Preparar o registro da instalação e o backup.
- Revisar compatibilidade dos workflows com nodes removidos.
- Testar em uma cópia da sua instância.
- Migrar conforme o seu cenário: npm ou Docker Compose.
- Validar execuções, credenciais e integrações.
- Resolver problemas que aparecerem depois.
Sem pressa
A 2.x recebe correções de segurança por 12 meses depois do lançamento oficial da 3.0. Use esse tempo para testar com calma. Cada tutorial informa o cenário, as versões de origem e de destino e a data da última revisão.
O n8n 3.0.0 saiu como pre-release em 27 de outubro de 2026. O lançamento oficial está previsto para o início de dezembro.
As mudanças citadas vêm da lista oficial de breaking changes, consultada em 28 de outubro de 2026.
Linha do tempo da migração
Marcos oficiais do n8n
- Beta publicadan8n 3.0.0 beta
A beta está disponível para testar a migração em uma cópia da sua instância.
- Início de dezembro de 2026Previsão, sem dia confirmadoLançamento da versão estável
O anúncio prevê a versão estável para o início de dezembro. Confira as notas da versão quando for atualizar.
- Prazo anunciadoFim do suporte ao n8n 1.x
Instalações na 1.x precisam passar pela 2.x para depois migrar para a 3.x.
- 12 meses após a versão estávelPrazo relativo ao lançamentoFim das correções para o n8n 2.x
A 2.x recebe correções de segurança e de bugs críticos por 12 meses após o lançamento estável da 3.x. O dia final depende dessa data.
Anúncio oficial do n8n · Consultado em 02/11/2026.
Entender
Identificar o que pode afetar o seu ambiente.
Preparar
Reunir instalação, dependências, credenciais e backup antes de mexer.
- DisponívelLeia o relatório de migração da sua instâncian8n 2.x para n8n 3.0Instância self-hosted com acesso de owner ou adminValidado em
- DisponívelRegistre a forma de instalação, o banco e as variáveis de ambienten8n 2.x para n8n 3.0Qualquer instalação self-hostedValidado em
- DisponívelAtualize do n8n 1.x para o 2.x antes da v3n8n 1.x para n8n 2.xInstalação na versão 1.xValidado em
- DisponívelFaça backup do banco e da chave de criptografian8n 2.x para n8n 3.0Docker com SQLite ou PostgresValidado em
Revisar compatibilidade
Saber quais workflows precisam de ajuste ou teste.
- DisponívelTroque Function e Function Item pelo Code noden8n 2.x para n8n 3.0Workflows com Function ou Function ItemValidado em
- DisponívelSubstitua o Item Lists pelo node de cada operaçãon8n 2.x para n8n 3.0Workflows com Item ListsValidado em
- DisponívelReescreva expressões que usam $getPairedItemn8n 2.x para n8n 3.0Workflows com expressões que usam $getPairedItemValidado em
Testar
Ver o comportamento em um ambiente separado antes da produção.
Migrar
Executar um procedimento validado para o seu cenário de instalação.
Validar
Conferir integrações, execuções e rotinas depois da atualização.
Resolver problemas
Tratar as falhas encontradas durante o processo.