Open WebUI voor beginners: installeren met Ollama
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)
- 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.
- Een model downloaden als de lijst leeg is:
ollama pull llama3.2:3b
- 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) |
-
Open de browser op http://localhost:8080 (het lokale adres van je machine).
-
Maak het beheerdersaccount: het eerste account dat je aanmaakt wordt beheerder (degene die gebruikers en instellingen beheert).
-
Kies het standaardmodel in de instellingen: selecteer
llama3.2:3bof het model dat je hebt gedownload. -
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 metipconfig(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-volumeopen-webuials 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):
- Controleer Python 3.10 of nieuwer:
python3 --version
- 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
- Start de server en wijs die naar de lokale Ollama:
export OLLAMA_BASE_URL=http://127.0.0.1:11434
open-webui serve
- Open de URL die de terminal toont (vaak http://localhost:8080), maak de beheerder aan en kies een model dat je al met
ollama pullhebt 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:
- Privéassistent voor het gezin — accounts en gebruik door meerdere mensen op dezelfde Open WebUI (vult het netwerkkader aan).
- Docker Ollama + Open WebUI — een stack die je kunt herhalen (meerdere pc’s of dezelfde back-ups).
- Eerste stappen met Whisper — spraak offline transcriberen na de tekstchat.
- SSD voor modellen — Docker-volumes en mappen van
ollama pullvoor 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
- Privéassistent voor het gezinAccounts en gewoontes om thuis te praten zonder cloud.
- Home Assistant en OllamaLokale HTTP-aanroepen vanuit je domotica.
- Lokale kosten tegenover ChatGPTHardware en kWh vergelijken over 3 jaar.
- SSD voor modellenOpslag inschatten voor GGUF en Docker.
- Whisper — eerste stappenSpraak offline transcriberen na de chat.
- Docker Ollama + Open WebUIEen stack die je op meerdere machines herhaalt.
- Ollama op WindowsHet eigen installatieprogramma als Open WebUI je volgende stap is.
- LM Studio en de GPUEen GGUF testen voor je hem via Ollama aanbiedt.
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