Open WebUI voor beginners: installeren met Ollama

Door Emmanuel Sauvage · Gepubliceerd · Bijgewerkt

Deze pagina kan Amazon-affiliatelinks bevatten. Een aankoop na een klik kan de site een commissie opleveren, zonder extra kosten voor jou. Het advies blijft onafhankelijk. Hoe affiliatie werkt.

Alleen Docker: reken op 45 minuten, plus 20 minuten als je de pip-bijlage gebruikt (het thuisnetwerk staat in het kader na de eerste chat).

Open WebUI is een prettige webpagina die aansluit op Ollama (de motor die LLM’s draait, large language models, op je pc). Iedereen thuis opent een pagina in de browser, in plaats van in een terminal te typen. Deze gids volgt één lijn: Docker plus Ollama, in de tijd hierboven. Ollama staat er al op (Windows, elk systeem of het pad van 15 minuten).

Voor wie Pad Tijd Wat je nodig hebt
Beginner, Docker staat er al Paragrafen 1 tot 4 hieronder 45 min (alleen Docker) Ollama draait, 16 GB RAM
Zonder Docker Pip-bijlage na de vergelijkingstabel +20 min (ongeveer 65 min in totaal) Python 3.10+
Gezin op tablets Netwerkkader na de eerste geslaagde chat +10 min extra Docker- of pip-installatie gelukt

Op deze pagina

Wat je nodig hebt

Onderdeel Detail
Ollama Service actief, standaardpoort 11434 — Ollama installeren als dat nog moet
RAM minstens 16 GB, 32 GB aanbevolen voor een model van 7B–8B (RAM 32/64)
Rechten Beheerder om Docker of Python te installeren
Netwerk Internet om Open WebUI één keer te downloaden; de chat kan daarna offline
Model Minstens één model al gedownload (een eerste model kiezen)
Schijf Ruimte voor Docker-images of een venv (SSD voor modellen als je GGUF-bestanden opstapelt)

Docker of pip: een vergelijking

Criterium Docker pip / kant-en-klaar programma
Eenvoud als Docker er al staat ★★★ ★★
Voorwaarde Docker Desktop of een Linux-motor Python 3.10+ of het officiële pakket
Updates docker pull (zie de bijlage bijwerken) Een opdracht of een installatieprogramma, volgens de documentatie
Netwerkisolatie Kan CORS-fouten geven (Cross-Origin Resource Sharing, de regels tussen browser en API) als het verkeerd staat Vaak eenvoudiger als alles puur lokaal draait
Gezin Stack dicht bij Docker Ollama + Open WebUI Minder containers

Eenvoud: ★ = een lang pad of veel afhankelijkheden; ★★ = een paar extra opdrachten; ★★★ = weinig stappen zodra het basisgereedschap er staat.

Staat Docker er niet op, open dan de pip-bijlage. Draai één methode op de machine, en stop de andere dienst voor je overschakelt.

Installatiestappen (Docker — het pad als Docker er al op staat)

  1. Ollama controleren — in een terminal:
curl http://127.0.0.1:11434/api/tags

Je moet JSON terugkrijgen (de lijst met modellen), of een leeg antwoord {"models":[]} als er nog geen model is gedownload.

  1. Een model downloaden als de lijst leeg is:
ollama pull llama3.2:3b
  1. Open WebUI starten — kopieer de hele opdracht zoals die er staat:

Kopieer het hele blok. Onder Windows PowerShell gebruik je één regel met backticks ` aan het eind voor de voortzetting, of je plakt het blok met meerdere regels zo in cmd, Linux of macOS.

docker run -d \
  -p 8080:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Optionele uitsplitsing (dezelfde opdracht, om elk stuk te begrijpen — overslaan als het blok hierboven werkt):

Fragment Rol
-d Container op de achtergrond
-p 8080:8080 Browserpoort naar de container
--add-host=host.docker.internal:host-gateway Ollama op de host bereiken vanuit Docker
-v open-webui:... Accounts en geschiedenis bewaren
ghcr.io/... Officiële image (controleer de documentatie als de tag verandert)
  1. Open de browser op http://localhost:8080 (het lokale adres van je machine).

  2. Maak het beheerdersaccount: het eerste account dat je aanmaakt wordt beheerder (degene die gebruikers en instellingen beheert).

  3. Kies het standaardmodel in de instellingen: selecteer llama3.2:3b of het model dat je hebt gedownload.

  4. Stuur een testbericht: “Vat in drie zinnen samen waarom lokale AI thuis van pas komt.”

Een antwoord in het Nederlands betekent dat de installatie gelukt is.

Na je eerste geslaagde chat

Netwerk, gezin en gegevens (één kader). Zolang je alleen op de pc test, blijf je op localhost. Voor een tablet op dezelfde wifi open je http://IP-VAN-DE-PC:8080 (LAN, local area network, het lokale ethernet- of wifinetwerk). Het IP-adres vind je met ipconfig (Windows), ip a (Linux) of Systeeminstellingen, Netwerk (macOS). Stuur poort 8080 en poort 11434 van de router niet door naar internet zonder VPN (virtual private network, een versleutelde tunnel) en sterke authenticatie. Het eerste account blijft beheerder: kies een stevig wachtwoord. Voor je bijlagen of gegevens van anderen toevoegt, lees je privacy en AI die 100 procent lokaal blijft. Voor accounts en gewoontes met meerdere gebruikers: privéassistent voor het gezin. Maak een back-up van het Docker-volume open-webui als de geschiedenis ertoe doet — zie SSD voor modellen.

Problemen oplossen

Poort 8080 is bezet, of de container ontbreekt

Verschijnsel: de container start niet, of de browser toont een andere site.

Oplossing Actie
Andere poort -p 8081:8080 in docker run, en open daarna http://localhost:8081
8080 vrijmaken docker ps, zoek de container, daarna docker stop naam
Firewall controleren Sta de gekozen poort alleen toe op het privénetwerk (zie het netwerkkader hierboven)

Verschijnselen en oplossingen

Verschijnsel Waarschijnlijke oorzaak Oplossing
Modellijst leeg Geen ollama pull ollama pull llama3.2:3b en de pagina verversen
502 / backend Ollama gestopt Start Ollama opnieuw; curl http://127.0.0.1:11434/api/tags
Geen model (Docker) Ollama-URL of CORS (Cross-Origin Resource Sharing, regels tussen browser en API) Variabele OLLAMA_BASE_URL=http://host.docker.internal:11434 (Docker Desktop) of het IP van de Linux-host; herstart de container
Witte pagina Container gestopt docker ps; docker start open-webui
Poort 8080 bezet Andere dienst Andere poort, of maak 8080 vrij (zie hierboven)
Trage interface Model te zwaar Model 3B of Q4 — een eerste model kiezen
Traag op het LAN Wifi vol Zet de server-pc op ethernet; controleer het netwerkkader
Wachtwoord vergeten Lokaal account Resetprocedure in de Open WebUI-documentatie, of opnieuw installeren met behoud van het volume
Pc 24 uur aan Stroomverbruik kWh-budget

Wat een gelukte installatie laat zien

  • Een lokale webpagina met chatgeschiedenis.
  • Beheerdersaccount aangemaakt, standaardmodel gekozen.
  • Een Nederlands antwoord in minder dan een minuut op een recente pc.

Fouten die opduiken vóór iemand hardware koopt

Fout Waarom het blokkeert Oplossing
Open WebUI starten zonder Ollama Lege backend, 502-fouten curl http://127.0.0.1:11434/api/tags en start daarna Ollama
Model van 70B op 16 GB RAM Schijf gaat swappen, pc bevriest Terug naar llama3.2:3b of een 7B in Q4 — een eerste model kiezen
LM Studio + Ollama + een GPU-game VRAM vol Sluit de andere GPU-apps; LM Studio blijft optioneel
Geschiedenis weg na docker pull Nieuwe container zonder volume Houd -v open-webui:/app/backend/data bij elke docker run

Open WebUI deelt dezelfde pc als Ollama. Je rondt deze handleiding af op de machine die je hebt. Heb je het model al lichter gemaakt (eerst 3B, dan 7B) en stoort de wachttijd nog steeds in het dagelijks gebruik, lees dan VRAM en modellen en de hardwarekiezer om RAM en GPU af te bakenen vóór een aankoop. Om mini-pc’s met 32 GB op de specificatie te vergelijken, is een zoekopdracht naar “minisforum 32gb” op Amazon.nl een beginpunt. Partnerlink: een commissie is mogelijk, zonder extra kosten voor jou. Controleer de actuele prijs en of het op voorraad is op de winkelpagina (hoe affiliatie werkt, oktober 2026). De vergelijking van mini-pc’s is de neutrale tekst als je wilt kiezen.

Bijlage — installatie met pip (zonder Docker)

Staat Docker er niet op, dan raadt de documentatie van Open WebUI vaak pip aan (de pakketbeheerder van Python):

  1. Controleer Python 3.10 of nieuwer:
python3 --version
  1. Maak een virtuele omgeving (aanbevolen) en installeer het officiële pakket. Controleer de versie op docs.openwebui.com op het moment van installeren:
python3 -m venv ~/.open-webui-venv
source ~/.open-webui-venv/bin/activate
pip install open-webui
  1. Start de server en wijs die naar de lokale Ollama:
export OLLAMA_BASE_URL=http://127.0.0.1:11434
open-webui serve
  1. Open de URL die de terminal toont (vaak http://localhost:8080), maak de beheerder aan en kies een model dat je al met ollama pull hebt gedownload.

Mislukken de afhankelijkheden, ga dan terug naar de tabel Docker/pip. Een kant-en-klaar programma zonder pip: handmatige installatie (officiële documentatie) of het pakket “Desktop” op docs.openwebui.com. Dezelfde volgorde (webserver, daarna beheerdersaccount, daarna de Ollama-backend op http://127.0.0.1:11434).

Bijlage — Open WebUI bijwerken (Docker)

Maak een back-up van het volume open-webui als de geschiedenis gevoelig is, en daarna:

docker stop open-webui
docker rm open-webui
docker pull ghcr.io/open-webui/open-webui:main
docker run -d \
  -p 8080:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Leg de opdracht naast docs.openwebui.com als de imagetag verandert. De stack met meerdere containers staat beschreven in Docker Ollama + Open WebUI.

Vragen over Open WebUI (bij deze gids)

Waarom toont de browser een CORS-fout met Docker?

CORS (Cross-Origin Resource Sharing, de regels tussen de browser en de Ollama-API) blokkeert Docker soms als de backend-URL niet klopt. Zet OLLAMA_BASE_URL=http://host.docker.internal:11434 (Docker Desktop), of het LAN-IP van de host-pc onder Linux, en herstart de container. Het detail staat in de tabel met problemen.

Kan LM Studio Open WebUI vervangen voor het gezin?

LM Studio heeft een grafische interface om GGUF-bestanden te testen. Ollama blijft vaak de API-backend voor Home Assistant of Continue. Voor een huishouden dat vooral in de browser praat, is Open WebUI plus Ollama genoeg. Zie LM Studio en GPU-offload ernaast, niet als tweede zware taak op dezelfde GPU.

Gaan de gesprekken naar internet?

Ze blijven op de machine zolang poort 8080 en poort 11434 dicht blijven voor internet en je geen cloudsynchronisatie aanzet. LAN, beheerder, back-up en de juridische verwijzing staan in het kader over netwerk en gegevens. Vergelijk lokale kosten met ChatGPT als je twijfelt tussen hardware en een abonnement.

Vier gidsen om daarna te lezen

Als localhost:8080 stabiel is, ga je verder zonder te veel diensten op te stapelen:

  1. Privéassistent voor het gezin — accounts en gebruik door meerdere mensen op dezelfde Open WebUI (vult het netwerkkader aan).
  2. Docker Ollama + Open WebUI — een stack die je kunt herhalen (meerdere pc’s of dezelfde back-ups).
  3. Eerste stappen met Whisper — spraak offline transcriberen na de tekstchat.
  4. SSD voor modellen — Docker-volumes en mappen van ollama pull voor je GGUF-bestanden opstapelt.

Meet de tijd van dezelfde vraag in 3B en daarna in 7B. Blijft de wachttijd acceptabel, stel een eigen mini-pc dan uit en kijk eerst naar 32 of 64 GB RAM.

Gerelateerde gidsen

Veelgestelde vragen

Docker, of een Python-installatie (pip)?

Zie de vergelijkingstabel Docker tegenover pip in deze gids. Kort: Docker als dat al geïnstalleerd is, anders pip of een kant-en-klaar programma (de inklapbare bijlage onderaan de pagina).

Kan ik Open WebUI vanaf een telefoon openen?

Ja, op het lokale netwerk (LAN), als de firewall de poort toelaat en je de dienst niet op internet zet zolang de aanmelding niet sterk is. Zie het netwerkkader na de Docker-installatie.

Het model staat niet in de lijst. Wat nu?

Voer ollama pull en de modelnaam uit in een terminal, en ververs daarna Open WebUI. Zie de tabel Problemen oplossen.

Vervangt Open WebUI Ollama?

Open WebUI is de webpagina. Ollama blijft de motor die de LLM’s op de achtergrond draait.

Bronnen

Verfijn het met de hardwarekiezer · Franse versie van deze rubriek