# Open WebUI instellen voor een lokale AI-chatinterface

Open WebUI instellen geeft je lokale AI een professionele webinterface die voelt als ChatGPT, maar volledig op je eigen infrastructuur draait. Met gebruikersaccounts, gespreksgeschiedenis en documentupload is het ideaal om lokale AI met een team te delen.

[[TOC]]

## Wat is Open WebUI?

Open WebUI is een gratis, open webinterface die bovenop Ollama draait. Waar Ollama zelf alleen een terminal en API biedt, voegt Open WebUI een complete chatomgeving toe in je browser. Meerdere mensen kunnen inloggen, gesprekken worden bewaard en je kunt documenten uploaden om vragen over te stellen.

:::info title="Browser in plaats van terminal"
Open WebUI maakt lokale AI toegankelijk voor niet-technische collega's. Zij openen gewoon een webpagina en chatten, zonder iets van de terminal of API te merken.
:::

## Wat je nodig hebt

Je hebt een draaiende Ollama-installatie nodig en Docker om Open WebUI te draaien. Docker zorgt ervoor dat alle onderdelen netjes in een container draaien zonder je systeem te vervuilen. Heb je Ollama en Docker al, dan ben je binnen enkele minuten klaar.

:::warn title="Controleer eerst Ollama"
Controleer voordat je begint of Ollama draait en bereikbaar is op poort 11434. Open WebUI heeft die verbinding nodig om modellen te kunnen gebruiken. Zonder werkende Ollama-server zie je geen modellen in de interface.
:::

## Open WebUI installeren met Docker

:::howto title="Installatie stap voor stap"
1. Zorg dat **Docker** is geinstalleerd en draait op je computer.
2. Open een terminal en start de container met het commando hieronder.
3. Wacht tot Docker de image heeft gedownload en de container draait.
4. Open je browser en ga naar `http://localhost:3000`.
5. Maak het eerste account aan, dit wordt automatisch de beheerder.
:::

Het startcommando ziet er zo uit:

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

Dit haalt de officiele image op, koppelt poort 3000 op je computer aan poort 8080 in de container en bewaart je data in een Docker-volume zodat gesprekken behouden blijven na een herstart. Met `--restart always` start de container automatisch weer op na een reboot.

:::tip title="Ollama meteen meeleveren"
Heb je nog geen Ollama draaien? Gebruik dan de gecombineerde image `ghcr.io/open-webui/open-webui:ollama`. Daarmee draaien Open WebUI en Ollama samen in een container, handig op een machine waar je alles in een keer wilt opzetten.
:::

## Koppelen aan Ollama

Open WebUI zoekt standaard naar Ollama op `host.docker.internal`, wat verwijst naar je eigen computer vanuit de container. In de meeste gevallen vindt het je Ollama-modellen automatisch. Zie je geen modellen, dan stel je het Ollama-adres handmatig in via de beheerinstellingen onder Admin Panel, Settings, Connections.

:::tip title="Ollama op een andere machine"
Draait Ollama op een andere machine in je netwerk? Vul dan in de instellingen het volledige adres in, bijvoorbeeld `http://192.168.1.50:11434`. Zo kan een lichte clientcomputer chatten met een krachtige AI-server elders.
:::

## Meerdere gebruikers instellen

Het eerste account dat je aanmaakt is de beheerder. Daarna kun je collega's uitnodigen of accounts aanmaken. Open WebUI gebruikt rolgebaseerde toegang (RBAC), zodat je per gebruiker bepaalt welke modellen beschikbaar zijn en welke rechten iemand heeft.

| Rol | Wat de rol kan |
| --- | --- |
| Admin | Beheert gebruikers, kiest welke modellen beschikbaar zijn, stelt het Ollama-adres in en bewaakt het systeem. Keurt nieuwe accounts goed en wijst rechten toe. |
| Gebruiker | Logt in, chat met de beschikbare modellen, bewaart eigen gesprekken en uploadt documenten. Ziet alleen de eigen geschiedenis. |

Nieuwe accounts staan standaard op de status `pending` totdat een beheerder ze goedkeurt. Zo bepaal jij wie er bij de AI en de gedeelde modellen kan.

## Documenten gebruiken

Een sterke functie van Open WebUI is documentupload. Je sleept een PDF of tekstbestand in de chat en stelt er vragen over. De interface knipt het document in stukken, zet die om naar embeddings en geeft de relevante delen aan het model mee. Dit is een eenvoudige vorm van een [[lokale-ai-rag-pipeline|RAG-pipeline]] zonder dat je zelf hoeft te programmeren. Voor herbruikbare kennis maak je via Workspace, Knowledge een collectie aan waar het hele team vragen over kan stellen.

:::warn title="Beveilig je interface"
Open WebUI is krachtig maar voegt een webserver toe aan je netwerk. Stel hem alleen open voor het internet met goede beveiliging, sterke wachtwoorden en bij voorkeur een reverse proxy met HTTPS. Anders kan iedereen je AI en geuploade documenten benaderen.
:::

:::faq
### Heb ik Docker nodig voor Open WebUI?
Docker is de aanbevolen en makkelijkste manier. Er bestaan ook andere installatiemethodes, bijvoorbeeld via pip, maar Docker geeft de minste problemen.

### Werkt Open WebUI met andere modellen dan Ollama?
Ja. Open WebUI kan ook met OpenAI-compatibele endpoints werken, waaronder LM Studio en clouddiensten, naast Ollama. Je kunt zelfs meerdere bronnen tegelijk koppelen.

### Kunnen meerdere mensen tegelijk chatten?
Ja. Open WebUI ondersteunt meerdere gebruikers met eigen accounts en gespreksgeschiedenis. De snelheid hangt af van de kracht van je AI-server, want alle gesprekken delen dezelfde Ollama-backend.

### Blijven mijn gesprekken bewaard na een herstart?
Ja, mits je het Docker-volume gebruikt zoals in het startcommando. De data staat dan veilig buiten de container, dus een nieuwe versie installeren wist je gesprekken niet.

### Op welke poort draait Open WebUI?
Standaard bereik je de interface op poort 3000 op je eigen computer. Binnen de container draait de app op poort 8080. Dat regelt het `-p 3000:8080` deel van het commando.
:::

Met Open WebUI deel je lokale AI eenvoudig met je team. Lees verder over [[lokale-ai-rag-pipeline|een eigen RAG-pipeline]] of [[ollama-docker-draaien|Ollama zelf in Docker draaien]].