Faça backup do banco e da chave e teste a restauração

As credenciais do n8n ficam cifradas no banco. Sem a chave correspondente, uma cópia do Postgres não consegue abri-las. Para recuperar a instância completa, você precisa reunir o banco, os arquivos persistentes e a configuração usada para conectar essas partes.

Prepare o conjunto de recuperação

Na instalação com Compose deste hotsite, preserve o banco Postgres e o volume montado em /home/node/.n8n. Guarde também o .env e o compose.yml, incluindo o valor de N8N_ENCRYPTION_KEY quando definido. Se a chave foi gerada automaticamente, ela está no arquivo config da pasta .n8n.

Inclua os arquivos binários e registros de execução mantidos fora desses caminhos. Diretórios indicados em N8N_CUSTOM_EXTENSIONS também precisam acompanhar a recuperação. Registre a versão da imagem e os locais de armazenamento utilizados, para não reconstruir a instalação por memória.

Produza o backup

Combine uma janela de manutenção e interrompa novas execuções. Aguarde as execuções em andamento terminarem antes de parar os processos do n8n. Essa organização permite copiar os componentes como um conjunto, sem novas alterações nos workflows durante a coleta.

Faça o backup do Postgres com as ferramentas do próprio banco. A documentação de Compose cita pg_dumpall antes de atualizar o Postgres. Escolha o procedimento de exportação e restauração compatível com sua instalação, incluindo permissões e usuários necessários. Copie a pasta .n8n e os caminhos adicionais definidos na configuração.

Em instalações com SQLite, pare o n8n antes de copiar a pasta, pois o arquivo do banco está nela. Copiar esse arquivo durante gravações pode produzir uma cópia inconsistente. Guarde os segredos com acesso restrito e mantenha uma cópia fora do servidor original.

Restaure em ambiente isolado

Use esta sequência como teste de recuperação:

1. Prepare uma instância separada, com a mesma versão do n8n registrada no backup. Isole as conexões externas para evitar disparos duplicados.
2. Com o n8n parado, restaure a pasta .n8n e os diretórios adicionais.
3. Restaure o Postgres pela ferramenta correspondente ao formato do backup.
4. Reponha as variáveis de conexão, a chave original e a configuração de armazenamento externo.
5. Inicie o n8n e confira os logs, os workflows e o histórico.

Escolha um workflow pequeno com uma credencial existente e um destino autorizado para teste. Execute-o na cópia e confira o resultado. Abrir o editor confirma apenas que a aplicação iniciou. Usar a credencial verifica também a descriptografia.

Exportações complementares

A CLI exporta workflows e credenciais com --backup, mas esses arquivos não incluem usuários, histórico, variáveis nem configurações da instância. Use-os como complemento, em pastas separadas, sem substituir o conjunto completo.

Para acompanhar o primeiro ensaio de recuperação no terminal, você pode usar o Desenvolvimento Colaborativo da Dev Side Studio. Registre o resultado do seu teste antes de depender desse backup para uma atualização.