N8N Data Migration Tool: Eenvoudig Migreren Tussen Databases (2025)

Inhoudsopgave

• Waarom Database Migratie?
• Wat is de Data Migration Tool?
• Export: Data Exporteren
• Import: Data Importeren
• Complete Migratie Stap-voor-Stap
• Beveiliging & Encryptie
• Veelvoorkomende Problemen

🎯 Waarom Database Migratie?

Veel gebruikers starten met N8N op SQLite voor het gemak en de eenvoud. Maar naarmate je automatisering groeit, heb je een robuustere database nodig. De nieuwe data migration tool maakt de overgang naar PostgreSQL eindelijk eenvoudig!

✨ Wat is de Data Migration Tool?

De nieuwe data migration tooling bestaat uit twee krachtige CLI commands:

Wat wordt er gemigreerd?

• 🔄 Workflows: Alle workflow definities en configuraties
• 🔐 Credentials: Alle opgeslagen credentials (geëncrypteerd)
• 🏷️ Tags: Workflow tags en categorieën
• 👥 Users: Gebruikers en team instellingen
• ⚙️ Settings: N8N instellingen en voorkeuren
• 📊 Variables: Environment variables

📤 Export: Data Exporteren

Het exporteren van je N8N data is eenvoudig met het nieuwe export:entities command.

Basis Export Command

# Standaard export
n8n export:entities --output=./n8n-backup

# Export zonder execution history
n8n export:entities --output=./backup --exclude=executions

# Met wachtwoord encryptie
n8n export:entities --output=./backup --password=strong-password

Export Opties

• --output: Output directory voor export bestanden
• --exclude: Entity types om uit te sluiten
• --include: Alleen specifieke entity types exporteren
• --password: Wachtwoord voor encryptie (aanbevolen!)

📥 Import: Data Importeren

Na het exporteren kun je de data importeren in je nieuwe N8N database met het import:entities command.

Basis Import Command

# Import vanuit export directory
n8n import:entities --input=./n8n-backup

# Import met wachtwoord
n8n import:entities --input=./backup --password=your-password

# Import met conflict strategie
n8n import:entities --input=./backup --on-conflict=skip

Conflict Strategieën

Als er al data bestaat in de doeldatabase:

• skip: Sla bestaande items over
• overwrite: Overschrijf bestaande items
• rename: Hernoem geïmporteerde items

📋 Complete Migratie: SQLite naar PostgreSQL

Stap 1: Stop N8N en Export Data

# Stop N8N
systemctl stop n8n

# Export data met encryptie
n8n export:entities --output=/backup/n8n --password=strong-pass --exclude=executions

Stap 2: Setup PostgreSQL

-- Maak database en user
CREATE DATABASE n8n;
CREATE USER n8n_user WITH PASSWORD 'secure_password';
GRANT ALL PRIVILEGES ON DATABASE n8n TO n8n_user;

Stap 3: Update N8N Config

# Update environment variabelen
export DB_TYPE=postgresdb
export DB_POSTGRESDB_HOST=localhost
export DB_POSTGRESDB_PORT=5432
export DB_POSTGRESDB_DATABASE=n8n
export DB_POSTGRESDB_USER=n8n_user
export DB_POSTGRESDB_PASSWORD=secure_password

Stap 4: Initialiseer Database en Import

# Start N8N om schema te maken
n8n start &
sleep 10
n8n stop

# Import data
n8n import:entities --input=/backup/n8n --password=strong-pass

Stap 5: Test en Valideer

# Start N8N
n8n start

# Verificatie
n8n workflow:list
n8n credential:list

🔐 Beveiliging & Encryptie

De data migration tool gebruikt AES-256-GCM encryptie voor maximale beveiliging:

Credentials Migratie

Credentials krijgen dubbele encryptie:

# Zorg dat encryption key consistent blijft
export N8N_ENCRYPTION_KEY="your-encryption-key"

n8n export:entities --output=./backup --password=pass
n8n import:entities --input=./backup --password=pass

🔧 Veelvoorkomende Problemen

❌ "Wrong password" error

# Controleer wachtwoord spelling
# Let op: wachtwoorden zijn case-sensitive

❌ Import faalt met "duplicate key"

# Gebruik conflict strategie
n8n import:entities --input=./backup --on-conflict=skip

❌ "Database connection failed"

# Test database connectie
psql -h localhost -U n8n_user -d n8n -c "SELECT 1;"

# Controleer environment vars
env | grep DB_

❌ Workflows werken niet na import

• ✓ Check dat N8N_ENCRYPTION_KEY hetzelfde is
• ✓ Verify dat credentials correct zijn geïmporteerd
• ✓ Test een simpele workflow eerst

🎯 Conclusie

De nieuwe N8N data migration tool is een game-changer voor het schalen van je automatisering. Met een paar CLI commands kun je nu:

• ✅ Veilig migreren tussen SQLite en PostgreSQL
• ✅ Complete backups maken van je N8N data
• ✅ Data verplaatsen tussen servers en environments
• ✅ Eenvoudig van development naar production gaan

De geëncrypteerde export en import functionaliteit zorgt ervoor dat je data altijd veilig is, terwijl het proces eenvoudig en betrouwbaar blijft.