Atualize e recomece a instância de estudo

Atualizar a imagem mantém o conteúdo persistente da instância. Recomeçar com um volume vazio apaga esse conteúdo. Você precisa escolher qual resultado pretende antes de executar os comandos, principalmente se já criou workflows que deseja reutilizar.

Copie os workflows antes de alterar

No exemplo deste lote, o container se chama n8n-estudo. Com ele em execução, rode no computador:

1
docker exec -u node -it n8n-estudo n8n export:workflow --all --output=/home/node/workflows-estudo.json
2
docker cp n8n-estudo:/home/node/workflows-estudo.json ./workflows-estudo.json

Confira se o arquivo existe no computador e contém os workflows esperados. Essa exportação permite levar os workflows para outra instância. Ela não inclui credenciais, usuários nem histórico de execuções.

Para recuperar a instância inteira com SQLite, faça também uma cópia da pasta persistente com o n8n parado. Execute na pasta do Compose, usando um destino novo:

1
docker compose stop n8n
2
docker cp n8n-estudo:/home/node/.n8n ./backup-n8n-antes-da-troca

A pasta reúne o SQLite e a configuração com a chave de criptografia neste exemplo. Guarde também o Compose e as variáveis personalizadas. A cópia com o serviço parado evita capturar o SQLite durante uma gravação.

Troque a versão sem apagar o volume

No compose.yaml, altere a tag da imagem para a versão escolhida. Consulte as notas dessa versão antes. Depois execute:

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

Abra o editor, confira os workflows e execute um teste de estudo. Se a atualização falhar, preserve o backup anterior. A recuperação completa depende da pasta persistente e da configuração, além da versão da imagem.

Na instalação pelo script oficial, use o comando de atualização na pasta acima de n8n:

1
curl -fsSL https://get.n8n.io | sh -s -- --upgrade

O script atualiza as versões do n8n e dos serviços de sandbox. Ele mantém os segredos e as demais configurações existentes.

Recomece somente depois de conferir as cópias

O comando abaixo apaga os volumes do projeto Compose. No exemplo local, isso remove workflows, credenciais, usuários e histórico guardados no SQLite:

1
docker compose down -v
2
docker compose up -d

Use somente na pasta da instância de estudo. Na instalação pelo script, o equivalente usa docker compose -f ./n8n/compose.yml down -v. Depois de subir novamente, complete a configuração inicial e importe os workflows copiados para o computador.