Atualize o n8n com backup e um caminho de recuperação

Uma atualização do n8n pode alterar o banco durante a inicialização. Por isso, o plano de recuperação precisa existir antes de trocar a imagem. Voltar a tag do container não desfaz as alterações já aplicadas aos registros da instância.

Defina a origem e o destino

Anote a versão em uso, a tag da imagem e a configuração atual. No projeto Compose, docker compose images lista as imagens dos serviços. Leia as notas de todas as versões entre a origem e o destino, procurando mudanças nos Nodes e nas variáveis que você utiliza.

A versão de referência deste guia é a estável 2.45.5. O n8n 3.0.0 saiu como pre-release em 27 de outubro de 2026, com lançamento oficial previsto para o início de dezembro. Uma migração para 3.x exige preparação própria. Abra Settings > Migration Report e confira Workflow issues e Instance issues, conforme o guia relacionado.

Teste uma cópia

Restaure o backup em um ambiente separado e aplique nele a versão de destino. Use os mesmos tipos de banco e armazenamento da instância original. Isole os triggers e os destinos externos para não repetir ações reais.

Execute os workflows representativos, incluindo webhooks, agendamentos, credenciais e processamento de arquivos. Compare as saídas esperadas e os logs. O relatório de migração orienta correções, mas não substitui esses testes.

Atualize a instância

Reserve uma janela de manutenção e interrompa novas chamadas e disparos. Aguarde as execuções terminarem. Faça um backup completo atualizado, incluindo banco, pasta .n8n, chave e configuração. Mantenha esse conjunto identificado com a versão de origem.

No .env, ajuste N8N_VERSION para a tag exata já testada. Na pasta do Compose, execute:

1
docker compose pull n8n
2
docker compose down
3
docker compose up -d
4
docker compose ps
5
docker compose images
6
docker compose logs n8n

O pull n8n baixa apenas a imagem do aplicativo. Não altere a versão principal do Postgres no mesmo procedimento. O down interrompe os serviços, mas a opção -v removeria os volumes e não faz parte desta atualização.

Confira a tag em execução e a conclusão da inicialização nos logs. Repita os testes de credencial e webhook antes de restabelecer as entradas externas. Compare o resultado dos workflows com o ensaio.

Se precisar retornar

Não há volta direta de 3.x para 2.x sobre o banco já migrado: a documentação informa que o banco migra apenas para a frente. Para recuperar a instalação 2.x, pare o n8n e restaure o backup anterior, com a pasta persistente, a chave e a configuração correspondentes. Inicie a imagem antiga somente sobre esse conjunto restaurado.

As execuções posteriores ao backup não pertencem à cópia restaurada. Avalie o que precisa ser conciliado nos sistemas externos antes de reabrir os triggers. Para acompanhar o ensaio ou a recuperação, o Desenvolvimento Colaborativo da Dev Side Studio oferece orientação técnica ao vivo.