Faça backup do banco e da chave de criptografia
Antes de começar
Ter um backup completo, capaz de devolver a instância ao estado anterior à v3.
- Registro da instalação feito no tutorial anterior.
- Espaço em disco fora do servidor para guardar o backup.
A atualização para a 3.x não tem volta. Segundo o anúncio oficial, voltar para a 2.x significa restaurar o backup feito antes. Para a rotação da chave de criptografia, ligada por padrão na v3, a documentação indica o backup do banco antes da atualização.
O que entra no backup completo
| Parte | Por que importa |
|---|---|
Pasta .n8n |
Guarda o arquivo config com a chave de criptografia. Com SQLite, guarda também o banco |
| Banco Postgres | Guarda workflows, credenciais cifradas, usuários e histórico |
| Armazenamento de arquivos | S3, Azure ou caminho próprio, quando configurados |
| Nodes próprios | Pastas definidas em N8N_CUSTOM_EXTENSIONS |
| Configuração | Variáveis de ambiente, incluindo N8N_ENCRYPTION_KEY se você define a chave por variável |
Sem a chave de criptografia, o banco restaurado não abre as credenciais.
Docker com SQLite
Pare o n8n antes de copiar. Copiar o banco com o n8n gravando pode gerar uma cópia inconsistente. Com Docker, a pasta .n8n fica no volume montado em /home/node/.n8n.
Docker com Postgres
Faça o dump do Postgres com a ferramenta do próprio banco. Copie também a pasta .n8n, porque a chave continua nela.
A exportação pela CLI não basta
Os comandos abaixo exportam só workflows e credenciais:
n8n export:workflow --backup --output=backups/workflows/n8n export:credentials --backup --output=backups/credentials/Usuários, histórico de execuções, variáveis e configurações ficam de fora. A exportação serve para levar workflows a outra instância. Para devolver a instância ao estado anterior, use o backup completo.
Teste a restauração
Um backup só está pronto depois de restaurado. Use o ambiente de testes da próxima etapa: restaure a pasta .n8n e o banco, suba a instância e abra um workflow que use credencial.
Confira o resultado
O backup contém a pasta .n8n com o arquivo config, o dump do Postgres quando houver e os arquivos externos. Uma restauração em instância de teste abre os workflows e as credenciais.
Fontes e conferência
Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.