Snabbstart
Krav
| Krav | Minimum | Rekommenderat |
|---|---|---|
| Node.js | 22.22+ | Senaste LTS |
| RAM | 8 GB | 16 GB+ |
| Disk | 5 GB | 20 GB+ för modeller |
| GPU | Valfri | 8 GB+ VRAM för snabb lokal inferens |
| Docker | Valfri | Krävs för Work-uppgifter |
Libre WebUI fungerar med CPU-baserad Ollama, men mindre modeller passar bättre. För molnleverantörer behövs bara relevant API-nyckel.
Chat, dokument, artifacts och leverantörsfunktioner kräver inte Docker. Work gör det: Docker måste finnas på backendmaskinen och backendprocessen måste få anropa det. npx libre-webui installerar inte Docker. Utan Docker fortsätter resten av Libre WebUI medan Work visar Runtime unavailable; modellkommandon körs aldrig direkt på värden som reserv.
Starta Libre WebUI
npx libre-webui@latest
Öppna http://localhost:8080. Det första kontot blir administratör. Senare offentlig registrering förblir avstängd om du inte anger ENABLE_SIGNUP=true.
Den paketerade startaren lagrar beständigt tillstånd i ~/.libre-webui. Ange absolut DATA_DIR för en annan plats; relativa värden löses från katalogen där npx körs.
Installera Ollama
Installera Ollama och hämta en liten generell modell:
ollama pull gemma4:12b
Andra starka val är gemma4:26b (MoE), gemma4:31b (dense) och qwen3.8:27b. Model Manager visar installerade modeller, söker i Ollama Library och hämtar modeller i appen.
Installera även en embeddingmodell för semantisk dokumentsökning:
ollama pull nomic-embed-text
Lägg till molnleverantörer
Molnleverantörer är valfria. Lägg nycklar per användare i Settings → API keys eller för hela servern i backend/.env och starta om backend, aktivera sedan leverantören:
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 uppdaterar modellistor när det stöds; dokumentationen behöver inte hållas öppen.
Starta din första Work-uppgift
Work ger varje uppgift en beständig konversation och ett separat containerbaserat filsystem. Funktionen är tillgänglig för autentiserade administratörer.
- Installera och starta Docker på backendmaskinen.
- Starta via Work i sidofältet,
+i flikraden, Home ellerCmd/Ctrl + Shift + U. - Välj en modell med verktygsstöd.
- Beskriv vad som ska byggas eller ändras och välj Run.
- Följ resultatet i Files, Activity, Git, Terminal och Preview.
Uppgiften och arbetsytan ligger kvar i sidofältet. Att stoppa körning eller förhandsvisning bevarar arbetsytan; radering tar bort den permanent.
Work kan använda installerad Ollama, Ollama Cloud eller ett konfigurerat chat/completion-insticksprogram. För en fjärrleverantör visas information om att leverantören får konversation, verktygsdefinitioner och begärda verktygsresultat. En autonom körning kan göra flera debiterbara anrop.
Se Work: isolerade arbetsytor för runtime, lagring, nätverk, förhandsvisning och säkerhet.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Skapa första administratören i webbläsaren; senare registrering är stängd som standard. Om Ollama redan kör på värden eller annan dator:
docker compose -f docker-compose.external-ollama.yml up -d
Använd repositoryts GPU-Compose-fil för NVIDIA. Compose-filerna monterar värdens Docker-socket för Work och ger appen root-likvärdig värdkontroll; läs Work: isolerade arbetsytor, ange DOCKER_GID i .env på Linux och ta bort monteringen om Work inte behövs.
Inbyggd Ollama är bara intern. Lägg till -f docker-compose.ollama-host.yml endast när en annan värdprocess behöver API:t; override binder till loopback som standard.
Hitta rätt
Home har Start, Continue och Explore. Samma mål finns i sidofältet och kommandopaletten (Cmd/Ctrl + K), som söker i chattar, Work-uppgifter, åtgärder och fulltext i meddelanden, anteckningar och dokument.
- Kalender — användarkalender med återkommande händelser.
- Automatiseringar — schemalagda AI-körningar som chattsessioner.
Kortkommandon
| Kortkommando | Åtgärd |
|---|---|
Cmd/Ctrl + K | Kommandopalett |
Cmd/Ctrl + Shift + O | Ny chatt |
Cmd/Ctrl + Shift + U | Ny Work-uppgift |
Cmd/Ctrl + B | Växla sidofält |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Växla tema |
? | Öppna fliken Shortcuts i Settings |
Esc | Stäng inställningsdialogen |
Enter | Skicka meddelande |
Shift + Enter | Ny rad |