Atualize do n8n 1.x para o 2.x antes da v3

O anúncio oficial do n8n 3.0 é direto: não existe caminho da 1.x para a 3.x. Uma instância 1.x precisa passar pela 2.x primeiro. O suporte à 1.x termina em 31 de dezembro de 2026.

Use o relatório da v2

A versão 2.0 também tem um relatório de migração em Settings > Migration Report. Na v2, ele fica disponível só para admins globais. Ele lista os workflows e as configurações que precisam de ajuste antes da 2.0.

Mudanças da 2.0 que mais aparecem

Mudança	O que fazer
Fim do suporte a MySQL e MariaDB como banco do n8n	Antes da 2.0, use a ferramenta de migração de banco para ir ao Postgres ou ao SQLite
Start node removido	Troque por Manual Trigger ou, em sub-workflows, por Execute Workflow Trigger
Code node sem acesso às variáveis de ambiente por padrão	Use credenciais ou defina N8N_BLOCK_ENV_ACCESS_IN_NODE=false
Execute Command e Local File Trigger desligados	Ajuste NODES_EXCLUDE se esses nodes forem necessários
Python com Pyodide removido do Code node	Reescreva o código em JavaScript
Opção n8n --tunnel removida	Use outro túnel para desenvolvimento

O node MySQL, usado dentro dos workflows, continua disponível. A mudança vale só para o banco da própria instância.

Ordem sugerida

1. Faça o backup completo descrito no tutorial de backup desta série.
2. Abra o relatório da v2 e corrija os itens apontados.
3. Atualize para a 2.0 em um ambiente de testes e confira os workflows principais.
4. Repita na instância principal.
5. Atualize até a última versão 2.x. O anúncio da v3 recomenda essa versão porque ela traz a versão mais nova do relatório de migração para a 3.0.

Depois disso, siga esta série a partir do relatório de migração.