Installation af Open WebUI og konfiguration af OmniProxy

Open WebUI er en selv-hostet chatgrænseflade, der kan installeres på din egen computer eller server og også kan køre helt offline. Den er ikke bundet til én modeludbyder: den kan oprette forbindelse til værktøjer såsom Ollama, der kører modeller lokalt, såvel som OpenAI-kompatible slutpunkter—adresser, der leverer modeltjenester ved hjælp af det samme anmodningsformat. Dette lader dig skifte mellem lokale og cloud-modeller i det samme vindue.

Den er velegnet til langvarig brug af teams og organisationer. Funktioner, der modtager hurtigere opdateringer, vises først i Computer, det produkt Open WebUI bruger til at afprøve nye funktioner.

Før du starter

Open WebUI er tilgængelig på macOS, Linux og Windows. Du kan installere den ved hjælp af Docker, Python eller Kubernetes. Docker pakker applikationen og dens runtime-miljø i en relativt isoleret container og er den anbefalede metode. Hvis Docker ikke er tilgængelig, kan du også bruge den testede Python-kommando nedenfor. Kubernetes er et system til implementering og styring af containere; se Quick Start linket i slutningen af denne guide for de tilsvarende trin.

Officielt anbefalet

Docker

• Én docker run kommando
• Åbn 3000 i browseren
• Data gemmes i volumen

Vil bare chatte

slim image

• Mindre downloadstørrelse
• Skift tagget til :slim
• Chat-funktionalitet forbliver tilgængelig

Ikke dækket her

To andre muligheder

• Manuel Python-installation
• Kubernetes-implementering
• Se den officielle Quick Start

Før du starter, skal du forberede følgende:

• Docker installeret og kørende.
• En hemmelig streng, der kun bruges af dig. Kør openssl rand -hex 32 for at generere en, og indtast den derefter som WEBUI_SECRET_KEY. Gem denne værdi permanent. Hvis du ændrer den, når du genopbygger containeren, vil brugere, der allerede er logget ind, blive logget ud.
• En kørende OmniProxy-instans og et model-ID fra dens aktuelle modelliste. Model-ID’et er det fuldstændige navn, der bruges til at vælge en specifik model.

Installation og første opstart

Åbn en terminal og kør kommandoen fra Quick Start. Erstat først your-secret-key med den hemmelighed, du lige har genereret:

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 dele af denne kommando tjener forskellige formål:

• -p 3000:8080: Lader dig åbne grænsefladen via port 3000 på denne computer. Hvis port 3000 allerede er i brug, skal du ændre tallet til venstre.
• -v open-webui:/app/backend/data: Gemmer chats, brugere og indstillinger i en datavolumen. En datavolumen er en placering uden for containeren, hvor data bevares langsigtet, så indholdet forbliver efter containeren er opdateret. Fjern ikke denne mulighed.
• --add-host=host.docker.internal:host-gateway: Giver containeren adgang til andre tjenester, der kører på denne computer.
• --restart always: Starter containeren igen, efter computeren genstarter.

Når kommandoen er færdig, skal du åbne http://localhost:3000 i en browser og følge instruktionerne på skærmen for at oprette den første konto.

Hvis du kun har brug for at chatte via et API, kan du ændre image-tagget fra :main til :slim. slim er et mindre image, der ikke inkluderer lokale tale- og embedding-modeller inde i containeren, men chatgrænsefladen forbliver tilgængelig. Fortsæt med at bruge :main hvis du har brug for disse lokale funktioner.

For manuelle opdateringer, kør først docker rm -f open-webui, kør derefter docker pull ghcr.io/open-webui/open-webui:main, og genstart den med den samme docker run kommando. Behold både datavolumen og WEBUI_SECRET_KEY uændret.

Hvis Docker ikke er tilgængelig

Quick Start tilbyder også en Python-installationsmetode. Den 2026-10-09 blev følgende kommando brugt på macOS til at installere Open WebUI v0.11.4 og fuldføre én samtale. Docker Desktop var ikke installeret på den computer på det tidspunkt.

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

Efter opstart, åbn http://localhost:8080 i en browser. Dette er porten, der bruges af Python-installationen, ikke Dockers port 3000.

En embedding-model downloades under den første opstart, hvilket kan tage flere minutter. En embedding-model konverterer tekst til data, der er lettere at søge i og matche. Vent på, at log-ind-siden vises, før du fortsætter. Den første registrerede konto bliver administratoren. Grænsefladesproget følger systemsproget; forenklet kinesisk blev vist under denne test.

DATA_DIR skal pege på en mappe, der bevares langsigtet og bruges til at gemme Open WebUI-data. Hvis den ikke er indstillet, kan dataene blive gemt i en midlertidig mappe og gå tabt efter nedlukning. Hvis WEBUI_SECRET_KEY ikke er indstillet, skriver programmet .webui_secret_key i den aktuelle mappe. Start den fra en mappe, du har til hensigt at bevare, eller indstil selv denne variabel.

Hent forbindelsesoplysninger 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 den adresse, Open WebUI bruger til at oprette forbindelse til slutpunktet, og den skal slutte med /v1. Tilføj ikke /chat/completions efter den; Open WebUI tilføjer automatisk den del.

Kopier det fuldstændige model-ID fra OmniProxy’s aktuelle liste. Hvis ID’et inkluderer et kildepræfiks og skråstreg, skal du også bevare dem. Følgende to korte navne er kun referencer fra udbyderdokumentationen pr. 2026-10-09. Brug dem ikke, hvis de ikke er på den aktuelle liste:

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

Indtast ikke en udbydernøgle i Open WebUI. Hvis gatewayen ikke validerer nøgler, skal du lade API-nøglen stå tom i stedet for at opfinde en anden nøgle.

Browser

Lokal port 3000

• Åbn chatsiden
• Fuldfør registrering først
• Åbn derefter indstillinger

Inde i containeren

Open WebUI

• Brug ikke localhost
• Brug værtsmaskinens navn i stedet
• URL'en slutter med /v1

Samme computer

OmniProxy

• Opbevar nøglen i gatewayen
• Brug gatewayens modelliste
• Gennemgå derefter anmodningslogfilerne

Hvis modeltjenesten kører på værten, mens Open WebUI kører i en Docker-container, skal du erstatte localhost i URL’en med host.docker.internal. Værten er den computer, der kører Docker direkte. Hvis OmniProxy kun lytter på denne computer, kan URL’en skrives som http://host.docker.internal:port/v1, og erstatte port med den port, OmniProxy faktisk bruger.

Hvis Open WebUI kører lokalt via Python-kommandoen i det forrige afsnit, og OmniProxy også kører lokalt, skal du bruge 127.0.0.1 eller localhost i adressen. Brug ikke host.docker.internal i dette tilfælde.

Indtast konfigurationen

I den forenklede kinesiske grænseflade af v0.11.4 testet den 2026-10-09, var navnene anderledes end Indstillinger > Admin > Forbindelser i de engelske instruktioner. Følg mulighederne vist i den testede grænseflade, oversat nedenfor:

1. Udvid venstre sidepanel.
2. Klik på brugermenuen nederst.
3. Klik på Indstillinger.
4. I administratorsektionen nedenfor, klik på Eksterne forbindelser.
5. Åbn OpenAI API.
6. Klik på + til højre for Administrer OpenAI API-forbindelser.
7. I dialogboksen Rediger forbindelse, indtast URL’en, der slutter med /v1. Behold API-typen indstillet til Chat Completions.
8. Behold Godkendelsesmetode indstillet til Nøgle (Bearer). Bearer-godkendelse placerer API-nøglen i anmodningen til identitetsbekræftelse. Hvis OmniProxy gav dig en nøgle, skal du indtaste den under API-nøgle. Hvis gatewayen ikke validerer nøgler, skal du lade dette felt stå tomt. Den 2026-10-09 lykkedes både validering og én samtale med feltet efterladt tomt.
9. Klik på Bekræft forbindelse ved siden af URL’en. Hvis OmniProxy leverer /models, vil modellisten blive hentet her.
10. Åbn Avanceret. Hvis Model-ID efterlades tomt, vil alle modeller returneret af /models på den adresse blive brugt. Kun hvis valideringen mislykkes, skal du indtaste et fuldstændigt ID fra listen under Tilføj model-ID, og derefter klikke på Tilføj. Tilføj hvert ID kun én gang; førende og efterfølgende mellemrum fjernes.
11. Klik på Gem i dette vindue, og klik derefter på Gem i nederste højre hjørne af siden Eksterne forbindelser.

At gemme konfigurationen alene erstatter ikke validering. Bekræft forbindelse anmoder om den anden tjenestes /models slutpunkt, som viser tilgængelige modeller. Nogle tjenester leverer ikke dette slutpunkt, så validering kan rapportere en fejl, selvom chat stadig kan fungere. I så fald skal du tilføje model-ID’et manuelt.

Bekræft en rigtig opgave

Gå tilbage til chatsiden, åbn modelmenuen ved siden af inputfeltet, og vælg det fuldstændige ID fra OmniProxy-listen. Send en meget kort besked, såsom at bede den om kun at svare med ét ord. Et svar skal faktisk vises i chatboksen.

Den 2026-10-09 blev denne samtale fuldført ved hjælp af Python-installationen af v0.11.4. Docker forbliver den anbefalede metode, men testen blev ikke gentaget i Docker.

Åbn derefter OmniProxy’s anmodningslogfiler og bekræft kilden og model-ID’et for denne anmodning. At se kun en vellykket lagring, eller kun se modellen i menuen, tæller ikke som fuldførelse.

Grænseflade

Modellen kan vælges

• Forbindelser er blevet gemt
• Modellen vises på listen
• Send et kort spørgsmål

Svar

Chatboksen viser et svar

• Det er ikke en tom besked
• Det er ikke en forbindelsesfejl
• Prøv igen med en anden model

Logfiler

Synlig i gatewayen

• Kilden er denne forbindelse
• Model-ID matcher
• Ingen nøgle blev indtastet på siden

Almindelige fejl

• localhost eller 127.0.0.1 blev brugt inde i containeren: Disse adresser peger på selve containeren, ikke værten. Skift adressen til host.docker.internal og bekræft, at opstartskommandoen inkluderer --add-host=host.docker.internal:host-gateway. Det omvendte gælder, når Open WebUI ikke kører i en container: brug en lokal adresse i stedet.
• Browseren kan ikke åbne siden: For Docker, tjek port 3000; for Python, tjek port 8080. Under den første opstart skal du vente på, at download af embedding-modellen er færdig. Du kan bruge docker ps til at bekræfte, om containeren kører. Hvis port 3000 allerede er i brug, skal du ændre porten på venstre side af -p.
• ID’et i modelmenuen er længere end udbyderens korte navn: Brug det fuldstændige ID fra menuen, inklusive eventuelle skråstreger.
• Alle er logget ud efter en opdatering: WEBUI_SECRET_KEY ændret. Genstart ved hjælp af den hemmelighed, der blev genereret første gang.
• Bekræft forbindelse mislykkes: Tilføj først manuelt model-ID’et under Avanceret, og bekræft det derefter med en rigtig chat på én sætning. Nogle tjenester leverer ikke /models, så chat kan stadig fungere, når validering rapporterer en fejl.
• Modellen findes ikke: Kopier ID’et igen fra OmniProxy’s aktuelle liste i stedet for at fortsætte med at bruge et forældet navn.

Officielle referencer

For installationskommandoer, se Open WebUI Quick Start. For forbindelsestrin, se OpenAI-kompatible forbindelsesinstruktioner. For model-ID’erne brugt i eksemplerne, se Claude modeloversigt og Gemini modelliste.

Erstat alle pladsholdere med værdier fra din egen OmniProxy-konfiguration. Publicér aldrig en rigtig nøgle.

Et gemt resultat eller HTTP 200 alene beviser ikke fuld agentkompatibilitet. Tjek kilden og modellen i OmniProxys anmodningspost.

Officielle kilder · Open WebUI ↗