n8n gebruiken op je VPS

n8n is een workflow-automation platform waarmee je apps, API's en AI-modellen aan elkaar koppelt zonder voor iedere stap losse scripts te hoeven schrijven.

Heb je een VPS met n8n voorgeïnstalleerd besteld, dan hoef je n8n zelf niet meer te installeren. In deze handleiding log je voor het eerst in, maak je je beheerdersaccount aan, koppel je een eerste LLM en bouw je direct een eenvoudige AI-workflow.

Waarvoor ga ik n8n gebruiken?

In deze handleiding laten we een heel eenvoudige workflow zien waarbij een AI Agent reageert op chat berichten. Zodra je eerste workflow werkt, kun je n8n voor veel meer gebruiken, bijvoorbeeld om:

Zonder AI

• Data op te halen uit API's en doorzetten naar andere systemen.
• Periodieke taken uit te voeren op basis van een schema.
• Periodiek meldingen versturen naar bijvoorbeeld Slack of e-mail.
• Formulieren, webhooks en AI-agents combineren in een workflow.

Met AI

Alle bovenstaande voorbeelden kunnen profiteren van een AI, maar wat dacht je van de volgende opties?

• Je ontvangt een bericht van een klant (via WhatsApp, mail, etc), maakt automatisch een ticket aan (bijv in Freshdesk), laat een AI Agent een antwoord opstellen (kennis via RAG), stuur een bericht naar een collega via een chat-kanaal (Slack, Mattermost), de collega controleert het antwoord en verstuurt die. 
• Genereer social media content gebaseerd op trending berichten die binnenkomen via kanalen naar keuze (Instagram, Reddit, etc)
• Logging & Alerting voor IT-systemen.
• Automatisering van je smart home.

En nog veel meer… je kan het zo gek niet bedenken; als je use-case maar ‘iets’ digitaals is met computers en/of servers, is er een hele goede kans dat je het kunt automatiseren met n8n. 

Voor het eerst inloggen op je n8n-VPS

Stap 1

Na het bestellen van je VPS met n8n ontvang je een e-mail met je loginggevens. Log in op je VPS en update je wachtwoord. Je krijgt nu eerst het volgende op je scherm te zien:

Hoewel optioneel, raden we aan om de instructie op te volgen en voor je verder gaat met stap 2 alvast een (sub)domein te verwijzen naar het IP-adres van je VPS. Host je je domein bij TransIP en maak je voor n8n een nieuw DNS-record aan? Dan is deze wijziging binnen enkele minuten verwerkt. 

Geef het wachtwoord van je VPS op om verder te gaan. De benodigde poorten worden automatisch geopend en je krijgt een bevestiging te zien zoals hieronder.

Stap 2

Maak je geen gebruik van een (sub)domein om aan n8n te koppelen? Ga dan verder met stap 3.

Open nu /opt/n8n/.env zoals aangegeven in de eerdere screenshot:

sudo nano /opt/n8n/.env

Pas in het bestand de volgende zaken aan (vooral niet de N8N_ENCRYPTION_KEY). 

• N8N_PROTOCOL: https
• N8N_SECURE_COOKIE: true
• DOMAIN_NAME: de domeinnaam die je aan je n8n-VPS koppelt. Gebruik je een sub-domein? Geef dan enkel de fully qualified domain name hier op, bijvoorbeeld example.com
• N8N_SUBDOMAIN: de naam van het subdomein zonder de fully qualified domain name, bijvoorbeeld n8n.
• SSL_EMAIL: het e-mailadres waarop je updates mbt SSL-certificaat vernieuwingen wil ontvangen. 

Stap 3

Open in je browser de URL van je n8n-installatie. Gebruik hiervoor het IP-adres van je VPS, of het (sub)domein dat je optioneel in stap 1 en 2 hebt gebruikt.

Maak nu eerst een nieuw account aan. Geef je e-mailadres, voor- en achternaam eneen wachtwoord op en selecteer optioneel ‘I want to receive security and product updates’. Je maakt hiermee het beheerdersaccount aan waarmee je workflows, credentials en instellingen beheert. Klik vervolgens op ‘Next’.

Je krijgt nog twee aanvullende onboarding-vensters te zien. In de eerste vertel je meer over je organisatie:

In het laatste venster krijg je de optie een gratis licentiesleutel te ontvangen voor betaalde features. Geef optioneel je e-mailadres op om hier gebruik van te maken.

Maak je gebruik van het aanbod voor een gratis licentiesleutel? Controleer dan je e-mail en klik op de link in de bevestiging.

Stap 4

Na het inloggen kom je op het overzicht van je n8n-installatie terecht. Hier maak en beheer je je workflows. Enkele nuttige onderdelen hier zijn:

1. Workflow of credentials aanmaken
2. Menu uitklappen
3. Workflow templates
4. Settings (hier beheer je onder andere gebruikers, SSO en instance-instellingen)

Je eerste eigen AI-workflow maken

In dit voorbeeld maken we een simpele AI-chatworkflow. Daarmee leer je meteen de basis van de n8n-editor en hoe je een LLM koppelt.

Stap 1

Klik op ‘+' > ‘Workflow’ of ‘Start from scratch’.

Stap 2

Klik op ‘Add first step’ en voeg de node ‘On chat message’ toe. Dit is de trigger waarmee je straks direct vanuit n8n je workflow kunt testen. 

Optioneel kun je dit ook vervangen door andere triggers (via ‘Search nodes’) zoals ‘Telegram message’. 

Het onderstaande venster verschijnt. Klik simpelweg op het kruisje om het te sluiten.

Stap 3

Klik daarna op de plus en 'AI'. 

Selecteer vervolgens de node ‘AI Agent’.

Stap 4

Het AI Agent Parameters-venster verschijnt. Klik onderaan op ‘Chat Model’.

Je hebt nu drie belangrijke onderdelen:

• Een trigger die de workflow start.
• Een AI Agent die de prompt verwerkt.
• Een chatmodel dat de daadwerkelijke AI-respons genereert.

Je workflow ziet er nu (met een Ollama-model) bijvoorbeeld als volgt uit:

Ben je tevreden met je workflow? Druk dan op 'Shift' + 'P' om je workflow te publiceren.

De AI Agent aanpassen

De AI Agent komt met een standaard instructie:

You're a helpful assistant

Wil je deze aanpassen? Dubbelklik dan in je workflow op AI Agent. Selecteer vervolgens onder ‘Add Option’ de optie ‘System Message’. 

Je kunt nu in real-time de instructie van je AI Agent aanpassen. 

Troubleshooting

Je LLM-node werkt niet

Controleer of je API-key correct is ingevoerd en of je account bij de LLM-provider (bijv OpenAI) actief is voor API-gebruik.

Je workflow reageert niet automatisch

Controleer of de workflow een trigger-node heeft en of je de workflow ook echt hebt gepubliceerd.

Je weet niet waarom een workflow faalt

Open Executions in n8n en bekijk per run welke node de fout geeft. In de meeste gevallen zie je daar direct de foutmelding en input/output terug.