Backup e atualização do n8n sem perder os fluxos

Atualizar o n8n é bom: correções, nós novos, compatibilidade. Atualizar sem backup é trocar o pneu sem estepe. O roteiro abaixo serve para n8n em Docker na sua VPS.

O que precisa estar no backup:

• O volume de dados do n8n (por padrão /home/node/.n8n dentro do contêiner). Ali estão o banco SQLite com fluxos, execuções, credenciais cifradas e as Data Tables.
• A N8N_ENCRYPTION_KEY. Sem ela, as credenciais do backup não abrem. Se você não definiu uma, o n8n gerou e guardou no arquivo config dentro do mesmo volume.
• O docker-compose.yml e o .env.
• Um export dos fluxos em JSON, como segunda camada. Dá para exportar pelo menu de cada fluxo ou pela linha de comando do n8n. O JSON não traz credenciais, mas permite reimportar num n8n novo.

Roteiro de atualização:

1. Faça o backup do volume e copie para fora da VPS.
2. Leia as notas da versão. Versão maior (1.x para 2.x, por exemplo) pode ter mudanças que quebram fluxos; versão menor, raramente.
3. Troque a tag da imagem no compose (você fixou a versão, certo?) para a nova versão exata.
4. docker compose pull e docker compose up -d. O n8n migra o banco sozinho ao subir.
5. Abra o n8n, rode um fluxo em modo teste, confira que os webhooks respondem.

Se algo quebrou: volte a tag anterior, restaure o volume do backup, suba de novo. Por isso o backup é antes, não depois: migração de banco não anda para trás.

Frequência: backup diário automático; atualização quando houver motivo (correção que te afeta, versão de segurança, compatibilidade de template), não a cada lançamento.