Atualizar n8n no Docker: passo a passo com backup

Aprenda a atualizar o n8n com Docker Compose ou docker run: backup, notas de versão, etiqueta fixa, conferência depois e como voltar atrás.

Por Redação Eleven Host · @robson.direitodigital · 27 de outubro de 2026 · 6 min de leitura

Para atualizar n8n instalado com Docker Compose, entre na pasta do docker-compose.yml e rode docker compose pull, docker compose down e docker compose up -d, depois de fazer o backup dos fluxos e das credenciais.

Este guia parte de uma instalação como a do Instalar n8n na VPS: passo a passo com Docker. Ele mostra o que ler antes, como fazer o backup, como atualizar com e sem Compose, como fixar a versão e como voltar atrás se algo sair do esperado. Os nomes (~/n8n, meu-n8n) são exemplos: troque pelos seus.

Antes de atualizar

Os dados do n8n ficam no volume n8n_data, montado em /home/node/.n8n. Ali estão o banco SQLite e a chave de criptografia. Se o volume for apagado, você perde fluxos e credenciais. Por isso, o backup vem antes de qualquer comando de atualização.

Leia também as notas de versão. Segundo a documentação do n8n, o projeto segue versionamento semântico, e uma versão maior (de 1.x para 2.x, por exemplo) traz mudanças incompatíveis que podem exigir ação sua. As notas de versão ficam em docs.n8n.io/release-notes. Elas descrevem ainda um relatório de migração, nas configurações do n8n, que marca o impacto das mudanças, inclusive o aviso "Upgrade blocked". Antes de pular uma versão maior, leia o que mudou.

Na data deste guia, as notas de versão mais recentes listadas são as da versão 2.45, de 20/10/2026.

Backup dos fluxos e das credenciais

A CLI do n8n exporta fluxos e credenciais. A opção --backup exporta só esses dois itens, um arquivo para cada. Rode os comandos dentro do container com docker exec. Primeiro descubra o nome do container:

docker ps

Depois exporte, trocando meu-n8n pelo nome que apareceu:

docker exec -u node -it meu-n8n n8n export:workflow --backup --output=/home/node/.n8n/backups/latest/

docker exec -u node -it meu-n8n n8n export:credentials --backup --output=/home/node/.n8n/backups/latest/

As credenciais saem criptografadas. Existe a opção --decrypted, que as exporta em texto puro, mas a documentação avisa que, com ela, todo dado sensível fica visível. Não use se não precisar.

Guarde também a chave de criptografia, que fica no volume. Sem ela, as credenciais exportadas criptografadas não abrem em outra instalação. Como a pasta de backup deste exemplo está dentro do volume, copie os arquivos e a chave para fora do servidor. Se preferir, faça ainda uma cópia do volume inteiro com o n8n parado.

Atualizar com Docker Compose

Vá para a pasta onde está o docker-compose.yml (no guia de instalação, é a ~/n8n) e baixe a imagem nova:

cd ~/n8n

docker compose pull

Depois recrie o container com a imagem baixada:

docker compose down

docker compose up -d

O down sem o -v remove o container e mantém o volume. O up -d sobe o n8n de novo em segundo plano. Confira se o container está de pé:

docker compose ps

Quer ver planos de n8n para os seus fluxos? Os planos começam em R$ 19,90/mês no n8n Essencial; confira na loja o que cada plano inclui. Ver planos de n8n

Atualizar sem Compose (docker run)

Se você subiu o n8n com docker run, o caminho tem mais passos. Baixe a imagem nova, ache o container, pare e remova:

docker pull n8nio/n8n

docker ps -a

docker stop <id>

docker rm <id>

Em seguida, rode o docker run de novo com as mesmas opções de antes e o mesmo volume. É o volume que faz o container novo encontrar os fluxos e as credenciais. Por isso, guarde o comando original num arquivo.

Fixar a versão do n8n

Sem etiqueta de versão na imagem, o pull pode trazer uma versão bem mais nova do que a que você usa, e você pode saltar de versão sem querer. Para controlar o passo, escreva a etiqueta da versão na imagem. Na página da documentação, em 27/10/2026, a versão estável era a 2.45.4 e a beta, a 2.46.0. No guia de instalação, a imagem é docker.n8n.io/n8nio/n8n. Para fixar, troque a linha da imagem no docker-compose.yml:

image: docker.n8n.io/n8nio/n8n:2.45.4

Depois rode o pull, o down e o up -d como antes. Para atualizar no futuro, troque o número da etiqueta, depois de ler as notas da versão.

A documentação também mostra a etiqueta next, que é a versão instável. Não use em produção.

Conferir depois da atualização

Com o container no ar, faça estas conferências:

• Olhe os registros por erros, e saia com Ctrl+C:

docker compose logs -f

• Abra o painel do n8n e confira a versão.
• Abra seus fluxos e confira se as credenciais continuam lá.
• Teste um fluxo com webhook. O guia Webhook no n8n: como criar, testar e colocar no ar mostra como criar e testar um webhook.

Quando estiver satisfeito, remova as imagens sem uso (as marcadas como dangling, sem etiqueta):

docker image prune

Se você pretende agendar o backup, o guia Como usar crontab: agende tarefas na VPS Linux explica o agendador do Linux.

Se der errado

Se o n8n não sobe ou o fluxo se comporta diferente, comece pelos registros do docker compose logs. Se a causa estiver na versão nova, volte para a etiqueta anterior no docker-compose.yml e repita o pull, o down e o up -d.

Atenção a um ponto: se a versão nova alterou os dados do volume, a versão anterior pode não conseguir lê-los. Nesse caso, restaure a cópia do volume feita antes da atualização, com o n8n parado. É o motivo de o backup vir primeiro. Se faltarem fluxos ou credenciais, importe os arquivos exportados no começo e confirme que a chave de criptografia é a mesma.

Prefere começar com um plano de n8n? Veja o n8n Essencial a partir de R$ 19,90/mês e compare os planos na loja; confira lá o que cada um inclui. Comparar planos de n8n

Perguntas frequentes

Como atualizar o n8n no Docker Compose?

Faça o backup, entre na pasta do docker-compose.yml e rode docker compose pull, docker compose down e docker compose up -d. Os dados ficam no volume.

Perco meus fluxos ao atualizar?

Os fluxos ficam no volume n8n_data, que o down mantém. O que coloca os dados em risco é o down -v ou a remoção do volume. Faça o backup antes da atualização.

Posso pular da versão 1 para a 2?

Segundo a documentação, uma versão maior traz mudanças incompatíveis que podem exigir ação sua. Leia as notas de versão e o relatório de migração antes, e faça o backup.

Como volto para a versão anterior?

Troque a etiqueta da imagem no docker-compose.yml pela anterior e recrie o container. Se o volume tiver sido alterado, restaure o backup.