O n8n atualiza-se baixando a imagem nova e recriando o contêiner. Os seus dados ficam, porque estão no volume. O que pode dar errado não é o comando, é saltar versões sem ler as notas e não ter cópia para onde voltar. Faça nesta ordem.
A atualização, por ordem
| 1 |
Faça uma cópia primeiro. Dados, compose e chave de criptografia, como em backup do n8n. Ao iniciar com uma versão nova, o n8n pode alterar a estrutura dos dados, e isso não se desfaz sozinho.
|
|
| 2 |
Leia as notas da versão no site do projeto, sobretudo se vai saltar várias versões de uma vez. É lá que vêm as mudanças que obrigam a alterar fluxos ou variáveis.
|
|
| 3 |
Ponha uma versão fixa no compose, em vez de uma etiqueta que anda sempre para a frente. O nome exato das etiquetas está na página da imagem oficial. Assim sabe sempre em que versão está e só muda quando decide.
|
|
| 4 |
Baixe e recrie com docker compose pull e docker compose up -d.
|
|
| 5 |
Veja os registros com docker compose logs. Procure erros nos primeiros momentos.
|
|
| 6 |
Teste os fluxos importantes à mão, um a um: um webhook, um agendamento, uma credencial de cada tipo.
|
|
O que costuma partir
| Sintoma |
Causa provável |
O que fazer |
| O n8n não inicia depois |
Uma variável antiga já não é aceita, ou a migração dos dados falhou. |
Leia os registros; compare as variáveis com as notas da versão. |
| Um nó deixou de funcionar |
Mudou o comportamento ou foi substituído. |
Procure o nó na documentação da sua versão. |
| As credenciais deram erro |
A chave de criptografia mudou, ou foi apagada com o volume. |
Ponha de volta a chave original. |
| Os webhooks não respondem |
O contêiner novo perdeu WEBHOOK_URL. |
Redefina a variável. Veja webhooks do n8n. |
|
Voltar atrás nem sempre é só mudar a versão. Se a versão nova já alterou a estrutura dos dados, voltar à antiga pode não funcionar. O caminho seguro é repor a cópia que fez no início e iniciar com a versão antiga.
|
Quando atualizar
Atualize de tempos a tempos, e sem pressa, mas não deixe passar muito. Uma instalação parada durante muito tempo acumula falhas de segurança conhecidas e torna o salto seguinte mais arriscado. Fora do horário em que os fluxos importantes correm, e com tempo para os testar. O método geral para qualquer aplicação em Docker está em atualizar uma aplicação Docker sem perder dados.
|
Se tem fluxos críticos, ensaie a atualização numa cópia: restaure a sua cópia num segundo VPS ou numa pasta à parte, atualize aí e só depois faça no verdadeiro. Também libera espaço no disco: Docker a encher o disco.
|
PRODUTO RECOMENDADO Servidor VPS com acesso root Recursos só seus, o sistema que escolher, reinstalação quando quiser. desde R$ 46,20/mês (plano de 3 anos, com cupom) Ver planos |
Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
