Monte um ambiente de testes a partir da sua instância
Antes de começar
Ter uma instância separada, com cópia da sua instância, rodando o n8n 3.0 pre-release para testar os workflows principais.
- Backup completo da sua instância.
- Servidor ou máquina separada da sua instância principal.
- Lista dos workflows mais executados, tirada do relatório.
O anúncio da v3 recomenda atualizar primeiro uma instância de teste ou homologação e só depois a instância principal. Uma cópia da sua instância mostra o comportamento real dos seus workflows na nova versão.
Monte a cópia
- Use um servidor ou uma máquina separada. A cópia não pode disputar banco, volumes ou domínio com a instância principal.
- Restaure o backup completo: pasta
.n8ncom o arquivoconfige, quando houver, o dump do Postgres. - Suba a instância na mesma versão 2.x da instância principal e confira se os workflows e as credenciais abrem.
Evite efeitos fora do teste
Uma cópia publicada dispara triggers de agendamento e responde webhooks como a instância principal. Antes de atualizar:
- despublique os workflows com Schedule Trigger ou triggers de aplicativos que enviem mensagens ou criem registros reais
- use outro domínio, para que os serviços externos continuem chamando só a instância principal
- troque credenciais de envio por credenciais de teste quando o workflow mandar e-mail ou mensagem.
Atualize a cópia para a 3.0
Troque a tag da imagem para a versão 3.0.0, seguindo o padrão de tags por versão da imagem oficial n8nio/n8n. Antes, confira o tutorial da etapa Migrar que corresponde ao seu cenário e o problema da pasta binaryData.
Compare as saídas
Para cada workflow da lista:
- Execute com a mesma entrada usada na instância principal.
- Compare número de itens, campos e mensagens de erro.
- Registre o resultado: igual, diferente ou falha.
Dê atenção às mudanças de comportamento sem erro: If e Switch com Always Output Data, Gmail Trigger antigo e Edit Image.
Confira o resultado
A instância de testes sobe na 3.0, abre os workflows com as credenciais e as saídas dos workflows principais batem com as da instância principal.
Fontes e conferência
Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.
