Troubleshooting

n8n start niet

Symptomen

• Website niet bereikbaar
• "502 Bad Gateway" foutmelding
• Container status is niet "Up"

Diagnose

Controleer de container status:

cd /opt/n8n
docker compose ps

Bekijk de logs:

docker compose logs n8n

Oplossingen

Containers herstarten:

docker compose restart

Containers volledig opnieuw opstarten:

docker compose down
docker compose up -d

Server herstarten:

sudo reboot

SSL certificaat problemen

Symptomen

• "Your connection is not private" waarschuwing
• Certificaat is verlopen
• Certificaat is voor verkeerde domein

Diagnose

Controleer Traefik logs:

cd /opt/n8n
docker compose logs traefik | grep -i acme

Oplossingen

DNS controleren:
Zorg dat je DNS A-record correct naar je server IP wijst.

Cloudflare proxy uitschakelen:
Als je Cloudflare gebruikt, zet de proxy op "DNS only" (grijs wolkje).

Certificaat opnieuw aanvragen:

cd /opt/n8n
docker compose down
# Verwijder oude certificaten
docker volume rm n8n_traefik_data
docker compose up -d

Let op: Vraag niet te vaak nieuwe certificaten aan. Let's Encrypt heeft een limiet van 5 certificaten per week per domein.

Webhooks werken niet

Symptomen

• Externe services kunnen je webhook niet bereiken
• "Connection timeout" bij webhook test
• Webhook URL geeft geen response

Diagnose

Test of je n8n bereikbaar is:

curl -I https://JOUW-N8N-URL/healthz

Oplossingen

Controleer firewall:

ufw status

Poorten 80 en 443 moeten open zijn.

Controleer webhook URL:

• De webhook URL moet beginnen met https://
• Gebruik de volledige URL uit n8n (inclusief het unieke pad)

Controleer workflow status:

• Is de workflow geactiveerd? (oranje toggle)
• Staat de webhook node correct geconfigureerd?

Test de webhook lokaal:

curl -X POST https://JOUW-N8N-URL/webhook/JOUW-WEBHOOK-PAD

Performance problemen

Symptomen

• n8n is traag
• Workflows duren lang
• Server reageert langzaam

Diagnose

Controleer resource gebruik:

docker stats

Controleer schijfruimte:

df -h

Oplossingen

Execution geschiedenis opschonen:
In n8n: Settings → General → "Delete data older than X days"

Docker opschonen:

docker system prune -a

Server upgraden:
Als je structureel tegen resource limieten aanloopt, overweeg een upgrade naar een zwaarder VPS pakket. Neem contact op met support@kratoshosting.com.

Wachtwoord vergeten (noodprocedure)

Als de "Forgot password" functie niet werkt, kun je via de command line een nieuw wachtwoord instellen:

docker exec -it n8n-n8n-1 n8n user-management:reset-password --email=JOUW-EMAIL

Volg de instructies om een nieuw wachtwoord in te stellen.

Contact & Support

Kom je er niet uit? We helpen je graag!

E-mail: support@kratoshosting.com
Website: kratoshosting.com

Handige links

• n8n Documentatie
• n8n Community Forum
• n8n Templates

Kratos Hosting - Where code meets creativity