Atualize uma instalação em Docker Compose

Este tutorial parte de uma instância em Docker Compose já na última versão 2.x, com o relatório de migração resolvido e o teste feito na homologação.

Antes de trocar a versão

1. Confira os volumes no compose.yml. Um volume montado em /home/node/.n8n/binaryData precisa passar para /home/node/.n8n/storage. Outra opção é definir N8N_STORAGE_PATH com o caminho antigo.
2. Confira as variáveis listadas no registro da instalação. Remova as que a v3 eliminou.
3. Se algum workflow usa Slack Trigger, preencha o signing secret na credencial do Slack.
4. Faça o backup completo.

Troque a tag e suba

No compose.yml, troque a tag da imagem do n8n para a versão 3.0.0, no padrão de tags por versão da imagem oficial. Depois, na pasta do arquivo:

1
docker compose pull
2
docker compose down
3
docker compose up -d

Acompanhe o log no primeiro início:

1
docker compose logs -f n8n

O primeiro início aplica as migrações do banco e renomeia a pasta de arquivos binários. Espere o editor responder antes de testar.

Se algo der errado

A 3.x não volta para a 2.x. Para retornar, pare os containers, restaure o backup completo e suba de novo com a tag 2.x anterior. Por isso o backup do mesmo dia é pré-requisito.

Depois da atualização

Siga para a etapa Validar e confira execuções, credenciais e integrações.