Exporte credenciais cifradas e preserve a chave

Este procedimento usa a referência 2.45.5 sem rotação de chaves habilitada. As credenciais ficam cifradas no banco do n8n. A exportação padrão pela CLI mantém essa proteção. Para restaurá-las em outra instância, você precisa também da chave de criptografia usada na origem. Um JSON cifrado sem a chave correspondente não permite recuperar os segredos.

Exporte sem expor os segredos no terminal

No computador, com o container de estudo em execução, rode:

1
docker exec -u node -it n8n-estudo n8n export:credentials --all --output=/home/node/credenciais-cifradas.json
2
docker cp n8n-estudo:/home/node/credenciais-cifradas.json ./credenciais-cifradas.json

O --output direciona a exportação para um arquivo. Sem essa opção, o comando pode imprimir o resultado no terminal. Confira se a cópia chegou ao computador antes de apagar ou recriar o container.

Para gerar um arquivo por credencial, use --backup --output=/home/node/credenciais-exportadas/. Essa pasta deve conter somente credenciais. Guarde os workflows em outro diretório para não misturar os arquivos na importação.

Preserve a chave correta

Na primeira inicialização, o n8n gera uma chave aleatória e a grava na pasta .n8n. No Docker deste lote, a configuração fica no volume montado em /home/node/.n8n, incluindo o arquivo config.

Se a instalação usa N8N_ENCRYPTION_KEY, preserve o valor configurado. Essa variável permite definir uma chave própria antes de existir uma chave no arquivo de configuração. Criar um valor novo no destino não decifra as credenciais antigas.

Para uma recuperação completa, mantenha a cópia da pasta persistente e da configuração da instalação. Com SQLite, pare o n8n antes de copiar a pasta. Evite colocar a chave em repositórios, mensagens ou capturas de tela.

Importe com a mesma chave

Prepare a instância de destino com a chave da origem e conclua a configuração do owner. Usando n8n-destino como exemplo de nome do container, execute:

1
docker cp ./credenciais-cifradas.json n8n-destino:/home/node/credenciais-cifradas.json
2
docker exec -u node -it n8n-destino n8n import:credentials --input=/home/node/credenciais-cifradas.json

A importação exige um usuário existente. Em instalações com vários usuários ou projetos, a CLI aceita --userId ou --projectId para definir o destino. Essas opções não podem ser combinadas. IDs já existentes podem ser sobrescritos.

Com rotação de chaves habilitada, o n8n também mantém chaves cifradas no banco. Preserve o backup completo da instância para esse cenário.

Exportação em texto legível

A opção --decrypted expõe os segredos no JSON. A documentação apresenta essa alternativa para transferência entre instalações com chaves diferentes, mas o arquivo exige a mesma proteção dos tokens originais e deve ser removido após o uso. O procedimento deste guia mantém a exportação cifrada e termina com o teste da credencial no serviço correspondente.