Volledige Dify Tutorial voor Beginners (2026)
Deze stap-voor-stap tutorial begeleidt je van nul naar een werkende AI-chatbot met Dify. Geen voorkennis vereist. Aan het einde heb je een gepubliceerde chatbot aangedreven door je favoriete LLM — klaar om te delen.
Wat is Dify?
Dify is een open-source platform voor het bouwen van LLM-aangedreven applicaties. Het biedt een visuele interface voor het maken van chatbots, AI-agenten en RAG-toepassingen — zonder code te schrijven. Zie het als een complete toolkit voor AI-app-ontwikkeling: modelbeheer, kennisbanken, workflow-orkestratie en app-publicatie op één plek.
Dify ondersteunt alle grote AI-aanbieders (OpenAI, Anthropic, Google Gemini, Mistral) en lokale modellen via Ollama. Jij beheert de prompts, de data en waar alles gehost wordt.
Vereisten
Zorg voor het volgende voordat je begint:
Wat je nodig hebt
Een Dify-account of server
Dify Cloud (gratis) of een VPS met Docker geïnstalleerd
Een LLM API-sleutel
OpenAI, Anthropic of Google Gemini — één is voldoende
Een webbrowser
Chrome, Firefox, Safari — elke moderne browser werkt
Basiskennis terminal
Alleen nodig bij zelf hosten. Niet vereist voor Dify Cloud.
Dify aan de praat krijgen
Je hebt twee opties. Kies degene die bij jouw situatie past:
Optie A: Dify Cloud
- Ga naar cloud.dify.ai
- Klik op "Get Started" en maak een gratis account aan
- Je bent erin — geen installatie nodig
Gratis tier: 200 berichtkredits/maand. Goed om te testen.
Optie B: Zelf hosten op Hetzner
- Hetzner CX22 server bestellen (~€3,79/maand)
- Inloggen via SSH en uitvoeren:
git clone https://github.com/langgenius/dify.git && cd dify/docker && docker compose up -d - Poort 80 openen — Dify is live
Je LLM verbinden
Dify moet verbonden zijn met een LLM voordat je iets kunt bouwen. Dit duurt minder dan 2 minuten:
Klik op je avatar (rechtsboven) → Instellingen
Ga naar "Modelaanbieders" in de linker zijbalk
Klik op OpenAI (of je favoriete aanbieder)
Plak je API-sleutel en klik op Opslaan
Haal je OpenAI-sleutel op bij platform.openai.com/api-keys
Klik op "Testen" om te controleren of de verbinding werkt
Je eerste chatbot maken
Laten we een eenvoudige klantenservice-chatbot bouwen. Dit duurt ongeveer 5 minuten:
Studio openen
Klik op "Studio" in de bovenste navigatiebalk.
App aanmaken
Klik op de "+ App aanmaken"-knop rechtsboven.
Chatbot kiezen
Kies "Chatbot" uit de app-type opties. Klik op Volgende.
App een naam geven
Geef het een naam zoals "Klantenservice-bot". Klik op Aanmaken.
Model selecteren
In de modelkiezer (rechtsboven op het canvas) kies GPT-4o of je favoriete model.
Systeemprompt schrijven
In het "Instructies"-tekstveld typ: "Je bent een behulpzame klantenservice-assistent. Wees beknopt, vriendelijk en nauwkeurig. Als je het antwoord niet weet, zeg dat dan."
Op Publiceren klikken
Druk op de blauwe "Publiceren"-knop rechtsboven. Je chatbot is nu live.
Testen & Delen
Nu controleren we of het werkt en delen we het met anderen:
Voorbeeldvenster
Aan de rechterkant van de Studio zie je een chat-voorbeeld. Typ een bericht en druk op Enter om je bot te testen. Wijzigingen aan de systeemprompt worden onmiddellijk weergegeven in de voorbeeldmodus.
Deellink
Na publicatie ga je naar Overzicht → klik "Uitvoeren" om de publieke chatpagina te openen. Kopieer de URL en deel die met iedereen — ze kunnen chatten met je bot zonder in te loggen bij Dify.
Insluiten op een website
Ga naar Overzicht → Insluiten → kopieer de iframe of scripttag. Plak het in elke website om een chat-widget toe te voegen. Volledig aanpasbare kleuren en positie.
API-toegang
Elke Dify-app krijgt automatisch een REST API. Ga naar API-referentie om je API-sleutel te ophalen en roep het aan vanuit elke applicatie, inclusief n8n, Zapier of eigen code.
Een kennisbank aanmaken (RAG)
RAG (Retrieval-Augmented Generation) stelt je chatbot in staat om vragen te beantwoorden vanuit je eigen documenten. Dit is een van Dify's beste functies:
Klik op "Kennis" in de bovenste navigatie
Klik op "+ Kennis aanmaken"
Upload je documenten (PDF, Word, TXT, Markdown, webpagina's)
Kies chunk-instellingen (standaard werkt goed voor de meeste gevallen)
Klik op "Opslaan & Verwerken" — Dify splitst en embedt je documenten automatisch
Ga terug naar je chatbot in Studio → Context-sectie → klik "+ Toevoegen" → kies je kennisbank
Opnieuw publiceren. Je bot kan nu antwoorden vanuit je documenten.
Een workflow aanmaken
Dify-workflows maken het mogelijk om meerstaps AI-pipelines te bouwen met een visuele knooppunteditor. Dit is krachtiger dan een eenvoudige chatbot — je kunt LLM-aanroepen koppelen, HTTP-verzoeken doen, code uitvoeren en vertakken op basis van condities.
Start
Het invoerpunt. Definieert invoervariabelen (bijv. user_query).
LLM-knooppunt
Roept je AI-model aan met een prompt. Kan variabelen van eerdere knooppunten gebruiken.
HTTP-verzoek
Doet een API-aanroep naar elke externe dienst. Gebruik het om data op te halen.
Code-knooppunt
Voert Python of JavaScript uit om data te transformeren tussen stappen.
IF/ELSE
Vertakt de workflow op basis van condities. Leidt naar verschillende paden.
Einde
Het uitvoerknooppunt. Definieert wat wordt teruggegeven aan de gebruiker.
Volgende stappen
Je hebt je eerste Dify-chatbot gebouwd. Dit kun je als volgende verkennen:
Van Cloud naar Zelf Gehost overstappen
Verhuizen naar een VPS voor onbeperkte credits en volledige dataregie. Vanaf €3,79/maand.
Zelf-host-handleiding →Hostingkosten vergelijken
Het volledige kostenplaatje begrijpen — VPS vs. Dify Cloud vs. gratis tier.
Prijsgids →De beste aanbieders verkennen
Hetzner, Hostinger, DigitalOcean en meer vergelijken voor het zelf hosten van Dify.
Aanbieders vergelijken →Dify vs. Alternatieven
Ontdek hoe Dify zich verhoudt tot Flowise, n8n, LangFlow en OpenWebUI.
Alternatieven bekijken →Dify hosten op je eigen server
Dify Cloud is geweldig om te leren, maar de echte kracht ligt in zelf hosten: onbeperkte credits, volledige dataprivacy en geen maandelijkse SaaS-kosten. Begin voor slechts €3,79/maand op Hetzner.
Veelvoorkomende Fouten en Hoe Ze te Vermijden
1. Onjuiste Docker Configuratie
Een veelvoorkomende fout is het niet correct instellen van de Docker-compose configuratie. Dit kan leiden tot fouten zoals:
ERROR: for api Cannot start service api: Ports are not available: listen tcp 0.0.0.0:80: bind: address already in useDit gebeurt vaak omdat poort 80 al in gebruik is. Controleer welke service deze poort gebruikt met:
sudo lsof -i :80Los het op door de conflicterende service te stoppen of een andere poort te gebruiken in docker-compose.yml.
2. Vergeten Omgevingsvariabelen
Bij het opstarten van Dify kan het zijn dat je essentiële omgevingsvariabelen vergeet. Dit kan resulteren in een niet-functionele applicatie. Een foutmelding kan zijn:
ERROR: Missing required environment variable: OPENAI_API_KEYControleer je .env bestand en zorg ervoor dat alle vereiste variabelen zijn ingesteld.
3. Onvoldoende RAM Toegewezen
Dify vereist minimaal 4 GB RAM voor een goede werking. Bij onvoldoende geheugen kunnen er crashes optreden. Een symptoom hiervan is:
FATAL: Out of memoryVerhoog het RAM-geheugen van je server of optimaliseer je configuratie om het geheugengebruik te verminderen.
4. Verkeerde Versie van Dify
Gebruik je een verouderde versie van Dify, dan kunnen er incompatibiliteitsproblemen optreden. Dit kan leiden tot foutmeldingen zoals:
ERROR: Unsupported Dify versionControleer regelmatig op updates in de GitHub-repository en voer git pull uit om de nieuwste versie te verkrijgen.
Geavanceerde Configuratie
1. Verbeterde Logging
Om de foutopsporing te vergemakkelijken, kun je de logging-niveau's aanpassen in docker-compose.yml:
environment:
- LOG_LEVEL=debugDit geeft meer gedetailleerde logs, wat nuttig kan zijn bij het oplossen van problemen.
2. Beperk de CPU-gebruik
Om de prestaties te optimaliseren, kun je de CPU-toewijzing beperken in docker-compose.yml:
deploy:
resources:
limits:
cpus: '0.5'Dit voorkomt dat Dify te veel bronnen gebruikt, wat de stabiliteit van andere services op je server kan verbeteren.