Exporte e importe workflows pela CLI do n8n

O comando export:workflow grava a estrutura dos workflows em JSON. Você pode exportar todos de uma vez ou escolher um pelo ID. Esse arquivo permite transferir o trabalho para outra instância, mas as credenciais exigem uma exportação separada.

Exporte para um arquivo

Com o container n8n-estudo em execução, rode no computador:

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

O primeiro comando grava dentro do container. O segundo retira a cópia para o diretório atual do computador. Abra o JSON e confira os nomes dos workflows antes de continuar. Para exportar somente um workflow, substitua --all por --id=ID_DO_WORKFLOW, preenchendo o ID real.

Um arquivo por workflow

A opção --backup combina --all, --pretty e --separate. Ela produz arquivos individuais com JSON formatado:

1
docker exec -u node -it n8n-estudo n8n export:workflow --backup --output=/home/node/workflows-exportados/
2
docker cp n8n-estudo:/home/node/workflows-exportados ./workflows-exportados

Use um destino novo para cada cópia no computador. Mantenha workflows e credenciais em pastas diferentes, pois a importação separada de credenciais pode falhar quando encontra arquivos de workflows no mesmo diretório.

O nome --backup descreve essas opções de exportação. Ele não inclui usuários, histórico de execuções, variáveis nem a configuração da instância.

Importe na instância de destino

Neste exemplo, n8n-destino representa o nome real do container de destino. Complete primeiro a configuração do usuário owner. Depois copie o arquivo e importe:

1
docker cp ./workflows.json n8n-destino:/home/node/workflows.json
2
docker exec -u node -it n8n-destino n8n import:workflow --input=/home/node/workflows.json

Para arquivos separados, copie a pasta e use n8n import:workflow --separate --input=/home/node/workflows-exportados/ dentro do container correspondente.

Confira IDs e publicação

A exportação inclui os IDs originais. Se o destino já possuir um workflow com o mesmo ID, a importação sobrescreve esse registro. Para criar uma cópia independente, remova ou altere os IDs no JSON antes de importar.

Por padrão, os workflows importados ficam desativados. A documentação registra um problema com agendamentos de workflows anteriormente ativos em instâncias sem multi-main: eles podem continuar executando até reiniciar o n8n. Depois da importação, reinicie a instância de estudo, confira as credenciais e teste cada workflow antes de publicar pelo editor.