Snel aan de slag
Vereisten
| Vereiste | Minimum | Aanbevolen |
|---|---|---|
| Node.js | 22.22+ | Nieuwste LTS-versie |
| RAM | 8 GB | 16 GB+ |
| Schijfruimte | 5 GB | 20 GB+ voor modellen |
| GPU | Optioneel | 8 GB+ VRAM voor snelle lokale inferentie |
| Docker | Optioneel | Vereist voor Work-taken |
Libre WebUI werkt met Ollama op alleen een CPU, maar kleinere modellen zijn daarvoor geschikter. Voor plug-ins van cloudproviders hebt u alleen de bijbehorende API-sleutel nodig.
Chat, documenten, artefacten en functies die via een provider werken, vereisen geen Docker. Work wel: Docker moet zijn geïnstalleerd op de computer waarop de Libre WebUI-backend draait en het backendproces moet Docker mogen aanroepen. De opdracht npx libre-webui installeert Docker niet. Als Docker niet beschikbaar is, blijft de rest van Libre WebUI werken terwijl Work Runtime unavailable meldt; modelopdrachten worden nooit als noodoplossing rechtstreeks op de host uitgevoerd.
Libre WebUI starten
npx libre-webui@latest
Open http://localhost:8080. Maak het eerste account aan; dat account wordt de beheerder. Openbare registratie blijft daarna uitgeschakeld, tenzij u ENABLE_SIGNUP=true expliciet instelt.
Het meegeleverde startprogramma bewaart permanente gegevens in ~/.libre-webui. Stel een absoluut DATA_DIR in om een andere locatie te kiezen; relatieve waarden worden herleid vanuit de map waarin u npx uitvoert.
Ollama installeren
Installeer Ollama en haal vervolgens een klein algemeen model binnen:
ollama pull gemma4:12b
Andere sterke keuzes zijn gemma4:26b (MoE), gemma4:31b (dense) en qwen3.8:27b. Gebruik Model Manager in Libre WebUI om geïnstalleerde modellen te bekijken, in de actuele Ollama Library te zoeken en modellen binnen te halen zonder de app te verlaten.
Installeer voor semantisch zoeken in documenten ook een embeddingmodel:
ollama pull nomic-embed-text
Cloudproviders toevoegen
Cloudproviders zijn optioneel. Voeg sleutels per gebruiker toe via Settings → API keys, of voor de hele server in backend/.env (start daarna de backend opnieuw), en schakel de provider vervolgens in via Settings:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
De app vernieuwt waar mogelijk de modellenlijsten van providers. U hoeft de documentatie niet open te houden om de nieuwste modelnamen te vinden.
Uw eerste Work-taak starten
Work geeft elke taak een permanente conversatie en een afzonderlijk bestandssysteem dat door een container wordt ondersteund. De functie is beschikbaar voor geauthenticeerde beheerders.
- Installeer en start Docker op de computer waarop de Libre WebUI-backend draait.
- Start een taak via de knop Work in de kop van de zijbalk, het menu
+in de tabbalk, de startpagina ofCmd/Ctrl + Shift + U. - Kies een model dat het aanroepen van tools ondersteunt.
- Beschrijf wat u wilt bouwen of wijzigen en selecteer vervolgens Run.
- Volg het resultaat via de tabbladen Files, Activity, Git, Terminal en Preview in het werkruimtepaneel.
De taak blijft in de zijbalk staan, zodat u later naar dezelfde conversatie en bestanden kunt terugkeren. Als u een uitvoering of voorbeeld stopt, blijft de werkruimte behouden. Als u de taak verwijdert, wordt de werkruimte definitief verwijderd.
Work kan een geïnstalleerd Ollama-model, een Ollama Cloud-model of een geconfigureerde plug-in voor een chat- of completionprovider gebruiken. Wanneer u een externe provider selecteert, toont Libre WebUI vóór de uitvoering een melding: de provider ontvangt de conversatie, tooldefinities en alle door het model opgevraagde toolresultaten. Een autonome uitvoering kan meerdere betaalde provideroproepen doen.
Zie Work: geïsoleerde werkruimten voor informatie over de runtime, persistentie, het netwerk, voorbeelden en beveiliging.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Maak de eerste beheerder aan in de browser. Er is geen registratievlag of herstart nodig; volgende openbare registraties zijn standaard gesloten.
Als Ollama al op de host of een andere computer draait:
docker compose -f docker-compose.external-ollama.yml up -d
Gebruik voor NVIDIA GPU-versnelling het GPU Compose-bestand uit de repository.
De Compose-bestanden van de repository koppelen de Docker-socket van de host, zodat Work beschikbaar is wanneer Docker is geïnstalleerd. Hierdoor krijgt de toepassing op de host rechten die gelijkstaan aan rootrechten. Lees daarom eerst Work: geïsoleerde werkruimten. Stel op Linux DOCKER_GID in .env in op de groep die eigenaar is van de socket. Verwijder de koppeling als u Work niet wilt gebruiken.
De meegeleverde Ollama is eveneens alleen intern bereikbaar. Voeg -f docker-compose.ollama-host.yml uitsluitend toe wanneer een ander hostproces toegang tot de API nodig heeft; de override bindt standaard aan loopback.
Uw weg vinden
Het tabblad Home heeft drie secties: Start (nieuwe chat, incognitochat, nieuwe Work-taak), Continue (uw recente conversaties en taken) en Explore (Notes, Calendar, Automations, Models, Personas, Imagine). Dezelfde bestemmingen staan in de navigatierij van de zijbalk en in het opdrachtenpalet (Cmd/Ctrl + K). Dat palet zoekt tolerant in uw chats, Work-taken en appacties en doorzoekt de volledige tekst van uw berichten, notities en documenten.
- Agenda — een agenda per gebruiker met terugkerende gebeurtenissen.
- Automatiseringen — geplande AI-uitvoeringen die als chatsessies worden afgeleverd.
Sneltoetsen
| Sneltoets | Actie |
|---|---|
Cmd/Ctrl + K | Opdrachtenpalet (werkt tijdens het typen) |
Cmd/Ctrl + Shift + O | Nieuwe chat |
Cmd/Ctrl + Shift + U | Nieuwe Work-taak |
Cmd/Ctrl + B | Zijbalk in- of uitschakelen |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Thema wisselen |
? | Settings openen op het tabblad Shortcuts |
Esc | Instellingenvenster sluiten |
Enter | Bericht verzenden |
Shift + Enter | Nieuwe regel |