Open WebUI-installasjon og OmniProxy-konfigurasjon

Open WebUI er et selvhostet chat-grensesnitt som kan installeres på din egen datamaskin eller server, og som også kan kjøres helt frakoblet. Den er ikke knyttet til én enkelt modell-leverandør: den kan koble til verktøy som Ollama som kjører modeller lokalt, samt OpenAI-kompatible endepunkter—adresser som leverer modelltjenester ved bruk av samme forespørselsformat. Dette lar deg bytte mellom lokale og skybaserte modeller i samme vindu.

Den er egnet for langvarig bruk av team og organisasjoner. Funksjoner som mottar raskere oppdateringer vises først i Computer, produktet Open WebUI bruker for å prøve ut nye funksjoner.

Før du starter

Open WebUI er tilgjengelig på macOS, Linux og Windows. Du kan installere den ved bruk av Docker, Python eller Kubernetes. Docker pakker applikasjonen og kjøretidsmiljøet i en relativt isolert container og er den anbefalte metoden. Hvis Docker ikke er tilgjengelig, kan du også bruke den testede Python-kommandoen nedenfor. Kubernetes er et system for distribusjon og administrasjon av containere; se hurtigstarten som er lenket på slutten av denne guiden for tilsvarende trinn.

Offisielt anbefalt

Docker

• Én docker run-kommando
• Åpne 3000 i nettleseren
• Data lagres i volumet

Vil bare chatte

slim-bilde

• Mindre nedlastingsstørrelse
• Endre taggen til :slim
• Chat-funksjonalitet forblir tilgjengelig

Ikke dekket her

To andre alternativer

• Manuell Python-installasjon
• Kubernetes-distribusjon
• Se den offisielle hurtigstarten

Før du starter, klargjør følgende:

• Docker installert og kjørende.
• En hemmelig streng som kun brukes av deg. Kjør openssl rand -hex 32 for å generere en, skriv den deretter inn som WEBUI_SECRET_KEY. Lagre denne verdien permanent. Hvis du endrer den når du bygger containeren på nytt, vil brukere som allerede er logget inn, bli logget ut.
• En kjørende OmniProxy-instans og en modell-ID fra den gjeldende modellisten. Modell-ID-en er det fullstendige navnet som brukes for å velge en spesifikk modell.

Installer og start for første gang

Åpne en terminal og kjør kommandoen fra hurtigstarten. Erstatt først your-secret-key med hemmeligheten du nettopp genererte:

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ølgende deler av denne kommandoen tjener forskjellige formål:

• -p 3000:8080: Lar deg åpne grensesnittet via port 3000 på denne datamaskinen. Hvis port 3000 allerede er i bruk, endre tallet til venstre.
• -v open-webui:/app/backend/data: Lagrer chatter, brukere og innstillinger i et datavolum. Et datavolum er en plassering utenfor containeren hvor data beholdes langsiktig, slik at innholdet forblir etter at containeren er oppdatert. Ikke fjern dette alternativet.
• --add-host=host.docker.internal:host-gateway: Lar containeren få tilgang til andre tjenester som kjører på denne datamaskinen.
• --restart always: Starter containeren på nytt etter at datamaskinen starter på nytt.

Etter at kommandoen er ferdig, åpne http://localhost:3000 i en nettleser og følg instruksjonene på skjermen for å opprette den første kontoen.

Hvis du bare trenger å chatte via et API, kan du endre bildetaggen fra :main til :slim. slim er et mindre bilde som ikke inkluderer lokale tale- og innebyggingsmodeller (embedding models) inne i containeren, men chat-grensesnittet forblir tilgjengelig. Fortsett å bruke :main hvis du trenger disse lokale funksjonene.

For manuelle oppdateringer, kjør først docker rm -f open-webui, kjør deretter docker pull ghcr.io/open-webui/open-webui:main, og start den på nytt med samme docker run kommando. Behold både datavolumet og WEBUI_SECRET_KEY uendret.

Hvis Docker ikke er tilgjengelig

Hurtigstarten gir også en Python-installasjonsmetode. Den 2026-10-09 ble følgende kommando brukt på macOS for å installere Open WebUI v0.11.4 og fullføre én samtale. Docker Desktop var ikke installert på den datamaskinen på det tidspunktet.

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

Etter oppstart, åpne http://localhost:8080 i en nettleser. Dette er porten som brukes av Python-installasjonen, ikke Dockers port 3000.

En innebyggingsmodell lastes ned under den første oppstarten, noe som kan ta flere minutter. En innebyggingsmodell konverterer tekst til data som er lettere å søke i og matche. Vent til påloggingssiden vises før du fortsetter. Den første registrerte kontoen blir administratoren. Grensesnittspråket følger systemets språk; forenklet kinesisk ble vist under denne testen.

DATA_DIR må peke til en katalog som vil bli beholdt langsiktig og brukes til å lagre Open WebUI-data. Hvis den ikke er satt, kan dataene bli lagret i en midlertidig katalog og gå tapt etter avslutning. Hvis WEBUI_SECRET_KEY ikke er satt, skriver programmet .webui_secret_key i gjeldende katalog. Start den fra en katalog du har til hensikt å beholde, eller sett denne variabelen selv.

Hent tilkoblingsdetaljer fra OmniProxy

Kopier følgende tre elementer fra 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 er adressen Open WebUI bruker for å koble til endepunktet og må slutte med /v1. Ikke legg til /chat/completions etter den; Open WebUI legger til den delen automatisk.

Kopier den fullstendige modell-ID-en fra OmniProxys gjeldende liste. Hvis ID-en inkluderer et kildeprefiks og skråstrek, behold dem også. De følgende to korte navnene er kun referanser fra leverandørdokumentasjon per 2026-10-09. Ikke bruk dem hvis de ikke er i gjeldende liste:

• Claude API-ID for Claude Sonnet 5.5: claude-sonnet-5-5
• API-navn for Gemini 3.8 Flash: gemini-3.8-flash

Ikke skriv inn en leverandørnøkkel i Open WebUI. Hvis gatewayen ikke validerer nøkler, la API-nøkkelen stå tom i stedet for å finne på en annen nøkkel.

Nettleser

Lokal port 3000

• Åpne chat-siden
• Fullfør registrering først
• Åpne deretter innstillinger

Inne i containeren

Open WebUI

• Ikke bruk localhost
• Bruk vertsmaskinens navn i stedet
• URL-en slutter med /v1

Samme datamaskin

OmniProxy

• Behold nøkkelen i gatewayen
• Bruk gatewayens modelliste
• Gjennomgå deretter forespørselsloggene

Hvis modelltjenesten kjører på verten mens Open WebUI kjører i en Docker-container, erstatt localhost i URL-en med host.docker.internal. Verten er datamaskinen som kjører Docker direkte. Hvis OmniProxy kun lytter på denne datamaskinen, kan URL-en skrives som http://host.docker.internal:port/v1, og erstatte port med porten OmniProxy faktisk bruker.

Hvis Open WebUI kjører lokalt gjennom Python-kommandoen i forrige seksjon og OmniProxy også kjører lokalt, bruk 127.0.0.1 eller localhost i adressen. Ikke bruk host.docker.internal i dette tilfellet.

Angi konfigurasjonen

I det forenklede kinesiske grensesnittet til v0.11.4 testet 2026-10-09, var navnene forskjellige fra Settings > Admin > Connections i de engelske instruksjonene. Følg alternativene som vises i det testede grensesnittet, oversatt nedenfor:

1. Utvid venstre sidefelt.
2. Klikk på brukermenyen nederst.
3. Klikk Settings.
4. I administratorseksjonen nedenfor, klikk External Connections.
5. Åpne OpenAI API.
6. Klikk + til høyre for Manage OpenAI API Connections.
7. I Edit Connection-dialogen, skriv inn URL-en som slutter på /v1. Behold API-typen satt til Chat Completions.
8. Behold Authentication Method satt til Key (Bearer). Bearer-autentisering plasserer API-nøkkelen i forespørselen for identitetsverifisering. Hvis OmniProxy ga deg en nøkkel, skriv den inn under API Key. Hvis gatewayen ikke validerer nøkler, la dette feltet stå tomt. Den 2026-10-09 lyktes både validering og én samtale med feltet stående tomt.
9. Klikk Verify Connection ved siden av URL-en. Hvis OmniProxy gir /models, vil modellisten bli hentet her.
10. Åpne Advanced. Hvis Model ID står tom, vil alle modeller returnert av /models på den adressen bli brukt. Kun hvis valideringen feiler, skriv inn en fullstendig ID fra listen under Add Model ID, og klikk deretter Add. Legg til hver ID kun én gang; ledende og etterfølgende mellomrom fjernes.
11. Klikk Save i dette vinduet, klikk deretter Save i nedre høyre hjørne av External Connections-siden.

Å lagre konfigurasjonen alene erstatter ikke validering. Verify Connection ber om den andre tjenestens /models endepunkt, som lister tilgjengelige modeller. Noen tjenester leverer ikke dette endepunktet, så validering kan rapportere en feil selv om chat fortsatt kan fungere. I så fall, legg til modell-ID-en manuelt.

Bekreft en ekte oppgave

Gå tilbake til chat-siden, åpne modellmenyen ved siden av inntastingsfeltet, og velg den fullstendige ID-en fra OmniProxy-listen. Send en veldig kort melding, for eksempel ved å be den svare med kun ett ord. Et svar må faktisk vises i chat-boksen.

Den 2026-10-09 ble denne samtalen fullført ved bruk av Python-installasjonen av v0.11.4. Docker forblir den anbefalte metoden, men testen ble ikke gjentatt i Docker.

Deretter, åpne OmniProxys forespørselslogger og bekreft kilden og modell-ID-en for denne forespørselen. Å bare se en vellykket lagring, eller bare se modellen i menyen, teller ikke som fullføring.

Grensesnitt

Modellen kan velges

• Connections har blitt lagret
• Modellen vises i listen
• Send et kort spørsmål

Svar

Chat-boksen viser et svar

• Det er ikke en tom melding
• Det er ikke en tilkoblingsfeil
• Prøv igjen med en annen modell

Logger

Synlig i gatewayen

• Kilden er denne tilkoblingen
• Modell-ID samsvarer
• Ingen nøkkel ble skrevet inn på siden

Vanlige feil

• localhost eller 127.0.0.1 ble brukt inne i containeren: Disse adressene peker til selve containeren, ikke verten. Endre adressen til host.docker.internal og bekreft at oppstartskommandoen inkluderer --add-host=host.docker.internal:host-gateway. Det motsatte gjelder når Open WebUI ikke kjører i en container: bruk en lokal adresse i stedet.
• Nettleseren kan ikke åpne siden: For Docker, sjekk port 3000; for Python, sjekk port 8080. Under den første oppstarten, vent til nedlastingen av innebyggingsmodellen er ferdig. Du kan bruke docker ps for å bekrefte om containeren kjører. Hvis port 3000 allerede er i bruk, endre porten på venstre side av -p.
• ID-en i modellmenyen er lengre enn leverandørens korte navn: Bruk den fullstendige ID-en fra menyen, inkludert eventuelle skråstreker.
• Alle er logget ut etter en oppdatering: WEBUI_SECRET_KEY endret. Start på nytt ved bruk av hemmeligheten som ble generert første gang.
• Verify Connection feiler: Legg først til modell-ID-en manuelt under Advanced, bekreft den deretter med en ekte chat på én setning. Noen tjenester leverer ikke /models, så chat kan fortsatt fungere når validering rapporterer en feil.
• Modellen eksisterer ikke: Kopier ID-en på nytt fra OmniProxys gjeldende liste i stedet for å fortsette å bruke et utdatert navn.

Offisielle referanser

For installasjonskommandoer, se Open WebUI Quick Start. For tilkoblingstrinn, se OpenAI-compatible connection instructions. For modell-ID-ene som brukes i eksemplene, se Claude model overview og Gemini model list.

Erstatt alle plassholdere med verdier fra din egen OmniProxy-konfigurasjon. Publisér aldri en ekte nøkkel.

Et lagret resultat eller HTTP 200 alene beviser ikke full kompatibilitet med en agent. Sjekk kilde og modell i OmniProxy sin kalllogg.

Offisielle kilder · Open WebUI ↗