Installation av Open WebUI och konfiguration av OmniProxy

Open WebUI är ett självhostat chattgränssnitt som kan installeras på din egen dator eller server och kan även köras helt offline. Det är inte bundet till någon enskild modell-leverantör: det kan ansluta till verktyg som Ollama som kör modeller lokalt, samt OpenAI-kompatibla slutpunkter—adresser som tillhandahåller modelltjänster med samma förfrågningsformat. Detta låter dig växla mellan lokala och molnbaserade modeller i samma fönster.

Det är lämpligt för långsiktig användning av team och organisationer. Funktioner som får snabbare uppdateringar visas först i Computer, produkten Open WebUI använder för att testa nya funktioner.

Innan du börjar

Open WebUI finns tillgängligt på macOS, Linux och Windows. Du kan installera det med Docker, Python eller Kubernetes. Docker paketerar applikationen och dess körmiljö i en relativt isolerad container och är den rekommenderade metoden. Om Docker inte är tillgängligt kan du även använda det testade Python-kommandot nedan. Kubernetes är ett system för att driftsätta och hantera containrar; se snabbstarten som länkas i slutet av denna guide för motsvarande steg.

Officiellt rekommenderat

Docker

• Ett docker run-kommando
• Öppna 3000 i webbläsaren
• Data lagras i volymen

Vill bara chatta

slim-avbildning

• Mindre nedladdningsstorlek
• Ändra taggen till :slim
• Chattfunktionaliteten förblir tillgänglig

Täcks inte här

Två andra alternativ

• Manuell Python-installation
• Kubernetes-driftsättning
• Se den officiella snabbstarten

Innan du börjar, förbered följande:

• Docker installerat och körs.
• En hemlig sträng som endast används av dig. Kör openssl rand -hex 32 för att generera en, ange den sedan som WEBUI_SECRET_KEY. Spara detta värde permanent. Om du ändrar det när du bygger om containern kommer användare som redan är inloggade att loggas ut.
• En körande OmniProxy-instans och ett modell-ID från dess aktuella modellista. Modell-ID:t är det fullständiga namnet som används för att välja en specifik modell.

Installera och starta för första gången

Öppna en terminal och kör kommandot från snabbstarten. Ersätt först your-secret-key med hemligheten du just genererade:

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=your-secret-key --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Följande delar av detta kommando tjänar olika syften:

• -p 3000:8080: Låter dig öppna gränssnittet via port 3000 på den här datorn. Om port 3000 redan används, ändra numret till vänster.
• -v open-webui:/app/backend/data: Lagrar chattar, användare och inställningar i en datavolym. En datavolym är en plats utanför containern där data bevaras långsiktigt, så dess innehåll finns kvar efter att containern uppdaterats. Ta inte bort detta alternativ.
• --add-host=host.docker.internal:host-gateway: Tillåter containern att komma åt andra tjänster som körs på den här datorn.
• --restart always: Startar containern igen efter att datorn startats om.

När kommandot är klart, öppna http://localhost:3000 i en webbläsare och följ instruktionerna på skärmen för att skapa det första kontot.

Om du bara behöver chatta via ett API kan du ändra avbildningstaggen från :main till :slim. slim är en mindre avbildning som inte inkluderar lokala tal- och inbäddningsmodeller inuti containern, men chattgränssnittet förblir tillgängligt. Fortsätt använda :main om du behöver dessa lokala funktioner.

För manuella uppdateringar, kör först docker rm -f open-webui, kör sedan docker pull ghcr.io/open-webui/open-webui:main och starta om den med samma docker run-kommando. Behåll både datavolymen och WEBUI_SECRET_KEY oförändrade.

Om Docker inte är tillgängligt

Snabbstarten tillhandahåller även en Python-installationsmetod. Den 2026-10-09 användes följande kommando på macOS för att installera Open WebUI v0.11.4 och slutföra en konversation. Docker Desktop var inte installerat på den datorn vid tillfället.

DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

Efter start, öppna http://localhost:8080 i en webbläsare. Detta är porten som används av Python-installationen, inte Dockers port 3000.

En inbäddningsmodell laddas ner under den första starten, vilket kan ta flera minuter. En inbäddningsmodell konverterar text till data som är lättare att söka och matcha. Vänta tills inloggningssidan visas innan du fortsätter. Det första registrerade kontot blir administratör. Gränssnittsspråket följer systemspråket; förenklad kinesiska visades under detta test.

DATA_DIR måste peka på en katalog som kommer att bevaras långsiktigt och användas för att lagra Open WebUI-data. Om den inte ställs in kan data lagras i en temporär katalog och gå förlorad efter avstängning. Om WEBUI_SECRET_KEY inte ställs in skriver programmet .webui_secret_key i den aktuella katalogen. Starta den från en katalog du avser att behålla, eller ställ in denna variabel själv.

Hämta anslutningsdetaljer från OmniProxy

Kopiera följande tre objekt från din egen OmniProxy-instans:

URL:      https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

URL:en är adressen Open WebUI använder för att ansluta till slutpunkten och måste sluta med /v1. Lägg inte till /chat/completions efter den; Open WebUI lägger till den delen automatiskt.

Kopiera det fullständiga modell-ID:t från OmniProxys aktuella lista. Om ID:t inkluderar ett källprefix och snedstreck, bevara dem också. Följande två korta namn är endast referenser från leverantörsdokumentationen per 2026-10-09. Använd dem inte om de inte finns i den aktuella listan:

• Claude API-ID för Claude Sonnet 5.5: claude-sonnet-5-5
• API-namn för Gemini 3.8 Flash: gemini-3.8-flash

Ange inte en leverantörsnyckel i Open WebUI. Om gatewayen inte validerar nycklar, lämna API-nyckeln tom istället för att hitta på en annan nyckel.

Webbläsare

Lokal port 3000

• Öppna chattsidan
• Slutför registreringen först
• Öppna sedan inställningar

Inuti containern

Open WebUI

• Använd inte localhost
• Använd värddatorns namn istället
• URL:en slutar med /v1

Samma dator

OmniProxy

• Behåll nyckeln i gatewayen
• Använd gatewayens modellista
• Granska sedan förfrågningsloggarna

Om modelltjänsten körs på värden medan Open WebUI körs i en Docker-container, ersätt localhost i URL:en med host.docker.internal. Värden är datorn som kör Docker direkt. Om OmniProxy endast lyssnar på den här datorn kan URL:en skrivas som http://host.docker.internal:port/v1, och ersätta port med porten OmniProxy faktiskt använder.

Om Open WebUI körs lokalt via Python-kommandot i föregående avsnitt och OmniProxy också körs lokalt, använd 127.0.0.1 eller localhost i adressen. Använd inte host.docker.internal i detta fall.

Ange konfigurationen

I det förenklade kinesiska gränssnittet för v0.11.4 som testades den 2026-10-09 skilde sig namnen från Settings > Admin > Connections i de engelska instruktionerna. Följ alternativen som visas i det testade gränssnittet, översatta nedan:

1. Expandera vänster sidofält.
2. Klicka på användarmenyn längst ner.
3. Klicka på Settings.
4. I administratörssektionen nedan, klicka på External Connections.
5. Öppna OpenAI API.
6. Klicka på + till höger om Manage OpenAI API Connections.
7. I dialogrutan Edit Connection, ange URL:en som slutar på /v1. Behåll API-typen inställd på Chat Completions.
8. Behåll Authentication Method inställd på Key (Bearer). Bearer-autentisering placerar API-nyckeln i förfrågan för identitetsverifiering. Om OmniProxy gav dig en nyckel, ange den under API Key. Om gatewayen inte validerar nycklar, lämna detta fält tomt. Den 2026-10-09 lyckades både validering och en konversation med fältet lämnat tomt.
9. Klicka på Verify Connection bredvid URL:en. Om OmniProxy tillhandahåller /models kommer modellistan att hämtas här.
10. Öppna Advanced. Om Model ID lämnas tomt kommer alla modeller som returneras av /models på den adressen att användas. Endast om valideringen misslyckas, ange ett fullständigt ID från listan under Add Model ID, klicka sedan på Add. Lägg till varje ID endast en gång; inledande och avslutande mellanslag tas bort.
11. Klicka på Save i detta fönster, klicka sedan på Save i det nedre högra hörnet på sidan External Connections.

Att bara spara konfigurationen ersätter inte validering. Verify Connection begär den andra tjänstens /models-slutpunkt, som listar tillgängliga modeller. Vissa tjänster tillhandahåller inte denna slutpunkt, så validering kan rapportera ett fel trots att chatt fortfarande kan fungera. I så fall, lägg till modell-ID:t manuellt.

Verifiera en verklig uppgift

Gå tillbaka till chattsidan, öppna modellmenyn bredvid inmatningsrutan och välj det fullständiga ID:t från OmniProxy-listan. Skicka ett mycket kort meddelande, som att be den svara med endast ett ord. Ett svar måste faktiskt visas i chattfönstret.

Den 2026-10-09 slutfördes denna konversation med Python-installationen av v0.11.4. Docker förblir den rekommenderade metoden, men testet upprepades inte i Docker.

Öppna sedan OmniProxys förfrågningsloggar och bekräfta källan och modell-ID:t för denna förfrågan. Att bara se en lyckad sparning, eller bara se modellen i menyn, räknas inte som slutförande.

Gränssnitt

Modellen kan väljas

• Anslutningar har sparats
• Modellen visas i listan
• Skicka en kort fråga

Svar

Chattfönstret visar ett svar

• Det är inte ett tomt meddelande
• Det är inte ett anslutningsfel
• Försök igen med en annan modell

Loggar

Synliga i gatewayen

• Källan är denna anslutning
• Modell-ID matchar
• Ingen nyckel angavs på sidan

Vanliga fel

• localhost eller 127.0.0.1 användes inuti containern: Dessa adresser pekar på containern själv, inte värden. Ändra adressen till host.docker.internal och bekräfta att startkommandot inkluderar --add-host=host.docker.internal:host-gateway. Det omvända gäller när Open WebUI inte körs i en container: använd en lokal adress istället.
• Webbläsaren kan inte öppna sidan: För Docker, kontrollera port 3000; för Python, kontrollera port 8080. Under den första starten, vänta tills nedladdningen av inbäddningsmodellen är klar. Du kan använda docker ps för att bekräfta om containern körs. Om port 3000 redan används, ändra porten på vänster sida av -p.
• ID:t i modellmenyn är längre än leverantörens korta namn: Använd det fullständiga ID:t från menyn, inklusive eventuella snedstreck.
• Alla loggas ut efter en uppdatering: WEBUI_SECRET_KEY ändrades. Starta om med hemligheten som genererades första gången.
• Verify Connection misslyckas: Lägg först till modell-ID:t manuellt under Advanced, bekräfta det sedan med en verklig chatt på en mening. Vissa tjänster tillhandahåller inte /models, så chatt kan fortfarande fungera när valideringen rapporterar ett fel.
• Modellen finns inte: Kopiera ID:t igen från OmniProxys aktuella lista istället för att fortsätta använda ett föråldrat namn.

Officiella referenser

För installationskommandon, se Open WebUI Quick Start. För anslutningssteg, se OpenAI-compatible connection instructions. För modell-ID:n som används i exemplen, se Claude model overview och Gemini model list.

Ersätt varje platshållare med värden från din egen OmniProxy-konfiguration. Publicera aldrig en riktig nyckel.

Ett sparat resultat eller HTTP 200 ensamt bevisar inte fullständig agentkompatibilitet. Kontrollera källa och modell i OmniProxys anropslogg.

Officiella källor · Open WebUI ↗