Pular para o conteúdo
EntrarCriar minha VPS

Como atualizar o n8n sem perder workflows

Para atualizar o n8n sem perder workflows, faça backup antes, depois atualize a imagem Docker e recrie o container, o processo leva menos de 5 minutos. Os workflows, credenciais e histórico ficam no volume persistente e sobrevivem à atualização; o que é substituído é apenas o código da aplicação.

Antes de atualizar: verifique o changelog

O n8n lança atualizações com frequência e às vezes quebra comportamentos de nodes em versões menores. Antes de atualizar, leia o changelog da versão alvo em docs.n8n.io/release-notes para verificar se algum node ou funcionalidade que você usa foi alterado.

Faça backup antes de qualquer atualização

Especialmente em major ou minor versions, sempre faça backup antes. Em caso de problema, você pode restaurar o estado anterior:

bash
# Backup rápido do volume antes de atualizar
docker run --rm   -v n8n_data:/data   -v $(pwd):/backup   alpine tar czf /backup/n8n-pre-update-$(date +%F).tar.gz -C /data .

Como atualizar o n8n (3 comandos)

Com o backup feito, o processo de atualização é simples, pull da nova imagem, parada do container atual e subida com a nova imagem:

bash
# 1. Baixar a imagem mais recente (ou a versão específica)
docker compose pull n8n

# 2. Recriar o container com a nova imagem
docker compose up -d n8n

# 3. Confirmar a versão instalada
docker compose exec n8n n8n --version

Como atualizar para uma versão específica

Se quiser controlar exatamente qual versão rodar (recomendado em produção), fixe a tag no docker-compose.yml:

yaml
# No docker-compose.yml, substitua :latest pela versão desejada
services:
  n8n:
    image: n8nio/n8n:1.94.1   # versão específica em vez de :latest

# Depois aplique:
docker compose up -d n8n

Como voltar para a versão anterior se algo quebrar

Se a atualização causar problema, você pode reverter mudando a tag no compose e recriando o container, ou restaurando o backup do volume:

bash
# Opção 1: voltar para versão anterior no docker-compose.yml
# image: n8nio/n8n:1.93.0

docker compose up -d n8n

# Opção 2: restaurar o backup de volume inteiro
docker compose stop n8n
docker run --rm   -v n8n_data:/data   -v $(pwd):/backup   alpine sh -c "rm -rf /data/* && tar xzf /backup/n8n-pre-update-2026-06-07.tar.gz -C /data"
docker compose start n8n

Cuidados em major versions (ex.: n8n 0.x → 1.x)

Major versions podem incluir migrações de banco de dados obrigatórias e mudanças de API nos nodes. Neste caso, leia as migration guides na documentação oficial antes de atualizar. O n8n executa migrações de banco automaticamente ao iniciar com uma nova major version, certifique-se de que o backup foi feito antes e de que não há execuções ativas no momento da atualização.

Não quer configurar manualmente?

Implante o n8n em menos de 5 minutos com a Runstack. Infraestrutura da OPEN Datacenter, com servidores em São Paulo.

Criar minha VPSVer apps prontos

Perguntas frequentes

Não. Workflows, credenciais e histórico ficam no volume Docker persistente, que não é afetado pela atualização da imagem. O que é substituído é apenas o código da aplicação n8n.

O comando docker compose pull baixa a nova imagem e docker compose up -d recria o container automaticamente. Haverá um breve downtime enquanto o container antigo para e o novo sobe (geralmente menos de 30 segundos).

Para correções de segurança, atualize assim que saírem. Para minor versions com novos nodes, atualize mensalmente ou a cada dois meses, sempre após testar em ambiente de homologação. Em produção, evite atualizar às sextas-feiras ou antes de períodos críticos de negócio.

O n8n roda as migrações de banco automaticamente na inicialização. Você não precisa rodar SQL manualmente. Mas o backup do banco antes da atualização é indispensável caso a migração falhe.

Após o docker compose up -d, verifique com docker compose ps (container deve estar healthy), docker compose exec n8n n8n --version (para confirmar a versão) e acesse a interface web para testar um workflow existente.

Continue lendo