Skip to main content

n8n

n8n is the workflow automation service.

Importing workflows (UI)​

Repository exports live under infrastructure/n8n/export/.

  1. Open the n8n editor.
  2. Menu -> Import from file
  3. Select the desired .json workflow.
  4. Save the workflow so it persists.

Import data tables​

  1. Go to Data Tables
  2. Import
  3. Select the Data Table JSON export.

Credentials management​

After importing workflows, some nodes will require credentials.

  1. Go to Credentials
  2. Add Credential
  3. Configure per integration (Zitadel, ThingsBoard, Chatwoot, ...)

Do not store real secrets in versioned exports. See docs/internal/operations/environments.md.

Import/Export strategy (CLI)​

Last reviewed: 2026-03-20

What is versioned​

  • Workflows and auxiliary tables under infrastructure/n8n/export/
  • Data tables under infrastructure/n8n/export/datatables/
  • Community nodes list in infrastructure/n8n/n8n_data/nodes/package.json

Legacy exports that previously contained fixed passwords were sanitized. Treat them as reference-only.

Useful CLI commands​

  1. n8n export:workflow --all --backup --output=/tmp/n8n-workflows
  2. n8n export:credentials --all --output=/tmp/n8n-credentials
  3. n8n export:entities --outputDir=/tmp/n8n-entities
  4. n8n import:workflow --separate --input=/tmp/n8n-workflows
  5. n8n import:credentials --input=/tmp/n8n-credentials
  6. n8n import:entities --inputDir=/tmp/n8n-entities

For cross-instance migration, ensure the encryptionKey matches, or export decrypted credentials with --decrypted.

  • Backups: docs/internal/operations/backups.md
  • Postgres: docs/internal/services/data-layer/postgres.md