Atualizar o n8n apaga meus workflows e credenciais?

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.

Posso atualizar sem parar o container?

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).

Com que frequência devo atualizar o n8n?

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.

Preciso fazer algo especial ao atualizar o banco de dados?

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.

Como saber se a atualização foi bem-sucedida?

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.

n8n/Artigo

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.

Dica

Se você usa a tag :latest, verifique qual versão está rodando atualmente: docker compose exec n8n n8n --version

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

Dica

O docker compose up -d recria o container automaticamente com a nova imagem quando ela foi atualizada pelo pull. Não é necessário docker compose down antes.

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

Atenção

Usar :latest em produção significa que a próxima chamada de docker compose pull pode trazer uma versão com breaking changes sem aviso. Fixe a versão e atualize deliberadamente.

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.

Atenção

Nunca pule múltiplas major versions de uma vez. Atualize de forma incremental (ex.: 0.x → 1.0 → 1.x) se disponível.

$ runstack deploy --plan starter

Não quer configurar manualmente?

Não quer configurar manualmente? Implante o n8n em menos de 3 minutos com a Runstack. Infraestrutura da OPEN DATACENTER, com servidores no Brasil.

Começar agora Ver planos e preços

Perguntas frequentes

Conteúdos relacionados

VPS para n8n no Brasil →Como instalar o n8n passo a passo →n8n não inicia: como resolver Como fazer backup do n8n n8n com PostgreSQL em produção