Hurtig start
Krav
| Krav | Minimum | Anbefalet |
|---|---|---|
| Node.js | 22.22+ | Seneste LTS |
| RAM | 8 GB | 16 GB+ |
| Disk | 5 GB | 20 GB+ for modeller |
| GPU | Valgfri | 8 GB+ VRAM for hurtig lokal inferens |
| Docker | Valgfri | Kræves for Work-opgaver |
Libre WebUI fungerer med CPU-baseret Ollama, men mindre modeller passer bedre. Til cloududbydere behøver du kun den relevante API-nøgle.
Chat, dokumenter, artifacts og udbyderfunktioner kræver ikke Docker. Work gør: Docker skal være installeret på backendmaskinen, og backendprocessen skal have tilladelse til at kalde det. npx libre-webui installerer ikke Docker. Uden Docker fortsætter resten af Libre WebUI, mens Work viser Runtime unavailable; modelkommandoer køres aldrig direkte på værten som reserve.
Start Libre WebUI
npx libre-webui@latest
Åbn http://localhost:8080. Den første konto bliver administrator. Senere offentlig registrering forbliver deaktiveret, medmindre du angiver ENABLE_SIGNUP=true.
Den pakkede starter gemmer vedvarende tilstand i ~/.libre-webui. Angiv en absolut DATA_DIR for en anden placering; relative værdier beregnes fra den mappe, hvor du kører npx.
Installer Ollama
Installer Ollama og hent en lille generel model:
ollama pull gemma4:12b
Andre stærke valg er gemma4:26b (MoE), gemma4:31b (dense) og qwen3.8:27b. Model Manager viser installerede modeller, søger i Ollama Library og henter modeller i appen.
Installer også en embeddingmodel for semantisk dokumentsøgning:
ollama pull nomic-embed-text
Tilføj cloududbydere
Cloududbydere er valgfrie. Tilføj nøgler per bruger i Settings → API keys eller for hele serveren i backend/.env og genstart backend, aktivér derefter udbyderen:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
Appen opdaterer modellisterne, når det understøttes; dokumentationen behøver ikke være åben.
Start din første Work-opgave
Work giver hver opgave en vedvarende samtale og et separat containerbaseret filsystem. Funktionen er tilgængelig for autentificerede administratorer.
- Installer og start Docker på backendmaskinen.
- Start via Work i sidepanelet,
+i fanebjælken, Home ellerCmd/Ctrl + Shift + U. - Vælg en model med værktøjsunderstøttelse.
- Beskriv hvad der skal bygges eller ændres og vælg Run.
- Følg resultatet i Files, Activity, Git, Terminal og Preview.
Opgaven og arbejdsområdet forbliver i sidepanelet. At stoppe kørsel eller forhåndsvisning bevarer arbejdsområdet; sletning fjerner den permanent.
Work kan bruge installeret Ollama, Ollama Cloud eller et konfigureret chat/completion-plugin. For en fjernudbyder vises det, at udbyderen modtager samtalen, værktøjsdefinitioner og de ønskede værktøjsresultater. En autonom kørsel kan foretage flere fakturerbare kald.
Se Work: isolerede arbejdsområder for runtime, lagring, netværk, forhåndsvisning og sikkerhed.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Opret den første administrator i browseren; senere registrering er lukket som standard. Hvis Ollama allerede kører på værten eller en anden computer:
docker compose -f docker-compose.external-ollama.yml up -d
Brug repositoryets GPU-Compose-fil til NVIDIA. Compose-filerne monterer værtens Docker-socket for Work og giver appen root-lignende kontrol over værten; læs Work: isolerede arbejdsområder, angiv DOCKER_GID i .env på Linux, og fjern monteringen, hvis Work ikke skal bruges.
Indbygget Ollama er kun intern. Tilføj til -f docker-compose.ollama-host.yml kun når en anden værtsproces behøver API:t; override binder til loopback som standard.
Find rundt
Home har Start, Continue og Explore. De samme destinationer findes i sidepanelet og kommandopaletten (Cmd/Ctrl + K), som søger i chats, Work-opgaver, handlinger og fuldtekst i beskeder, noter og dokument.
- Kalender — brugerkalender med tilbagevendende hændelser.
- Automatiseringer — planlagte AI-kørsler som chattsessioner.
Genvejstaster
| Genvej | Handling |
|---|---|
Cmd/Ctrl + K | Kommandopalet |
Cmd/Ctrl + Shift + O | Ny chat |
Cmd/Ctrl + Shift + U | Ny Work-opgave |
Cmd/Ctrl + B | Skift sidepanel |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Skift tema |
? | Åbn fanen Shortcuts i Settings |
Esc | Luk instællningsdialogen |
Enter | Send besked |
Shift + Enter | Ny linje |