Inštalácia Open WebUI a konfigurácia OmniProxy

Open WebUI je vlastné chatovacie rozhranie, ktoré možno nainštalovať do vlastného počítača alebo servera a môže bežať aj úplne offline. Nie je viazané na žiadneho jedného poskytovateľa modelov: dokáže sa pripojiť k nástrojom ako Ollama, ktoré spúšťajú modely lokálne, ako aj ku koncovým bodom kompatibilným s OpenAI—adresám, ktoré poskytujú modelové služby pomocou rovnakého formátu požiadaviek. To vám umožňuje prepínať medzi lokálnymi a cloudovými modelmi v rovnakom okne.

Je vhodné na dlhodobé používanie tímami a organizáciami. Funkcie, ktoré dostávajú rýchlejšie aktualizácie, sa najskôr objavia v Computer, produkte, ktorý Open WebUI používa na vyskúšanie nových funkcií.

Skôr než začnete

Open WebUI je k dispozícii na macOS, Linuxe a Windows. Môžete ho nainštalovať pomocou Docker, Pythonu alebo Kubernetes. Docker balí aplikáciu a jej runtime prostredie do relatívne izolovaného kontajnera a je odporúčanou metódou. Ak Docker nie je k dispozícii, môžete použiť aj nižšie uvedený testovaný príkaz Pythonu. Kubernetes je systém na nasadzovanie a správu kontajnerov; príslušné kroky nájdete v rýchlom štarte (Quick Start) prepojenom na konci tejto príručky.

Oficiálne odporúčané

Docker

• Jeden príkaz docker run
• Otvorte 3000 v prehliadači
• Údaje sú uložené vo zväzku (volume)

Chcem len chatovať

slim obraz

• Menšia veľkosť sťahovania
• Zmeňte tag na :slim
• Funkcionalita chatu zostáva dostupná

Tu nie je zahrnuté

Dve ďalšie možnosti

• Manuálna inštalácia Pythonu
• Nasadenie Kubernetes
• Pozrite si oficiálny rýchly štart

Pred začatím si pripravte nasledujúce:

• Nainštalovaný a spustený Docker.
• Tajný reťazec, ktorý používate iba vy. Spustite openssl rand -hex 32 na vygenerovanie jedného, potom ho zadajte ako WEBUI_SECRET_KEY. Túto hodnotu uložte natrvalo. Ak ju zmeníte pri opätovnom zostavovaní kontajnera, používatelia, ktorí sú už prihlásení, budú odhlásení.
• Spustenú inštanciu OmniProxy a ID modelu z jej aktuálneho zoznamu modelov. ID modelu je úplný názov používaný na výber konkrétneho modelu.

Inštalácia a prvé spustenie

Otvorte terminál a spustite príkaz z rýchleho štartu. Najprv nahraďte your-secret-key tajným kľúčom, ktorý ste práve vygenerovali:

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

Nasledujúce časti tohto príkazu slúžia na rôzne účely:

• -p 3000:8080: Umožňuje otvoriť rozhranie cez port 3000 v tomto počítači. Ak je port 3000 už obsadený, zmeňte číslo vľavo.
• -v open-webui:/app/backend/data: Ukladá chaty, používateľov a nastavenia do dátového zväzku. Dátový zväzok je umiestnenie mimo kontajnera, kde sa údaje uchovávajú dlhodobo, takže ich obsah zostáva aj po aktualizácii kontajnera. Túto možnosť neodstraňujte.
• --add-host=host.docker.internal:host-gateway: Umožňuje kontajneru prístup k iným službám spusteným v tomto počítači.
• --restart always: Znova spustí kontajner po reštarte počítača.

Po dokončení príkazu otvorte http://localhost:3000 v prehliadači a postupujte podľa pokynov na obrazovke na vytvorenie prvého účtu.

Ak potrebujete chatovať iba cez API, môžete zmeniť tag obrazu z :main na :slim. slim je menší obraz, ktorý neobsahuje lokálne modely reči a vkladania (embedding) vo vnútri kontajnera, ale chatovacie rozhranie zostáva dostupné. Naďalej používajte :main ak potrebujete tieto lokálne funkcie.

Pre manuálne aktualizácie najprv spustite docker rm -f open-webui, potom spustite docker pull ghcr.io/open-webui/open-webui:main, a reštartujte ho rovnakým docker run príkazom. Ponechajte dátový zväzok aj WEBUI_SECRET_KEY nezmenené.

Ak Docker nie je k dispozícii

Rýchly štart poskytuje aj metódu inštalácie cez Python. Dňa 9. 10. 2026 bol na macOS použitý nasledujúci príkaz na inštaláciu Open WebUI v0.11.4 a dokončenie jednej konverzácie. Docker Desktop v tom čase v počítači nebol nainštalovaný.

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

Po spustení otvorte http://localhost:8080 v prehliadači. Toto je port používaný inštaláciou Pythonu, nie port 3000 Dockeru.

Počas prvého spustenia sa stiahne model vkladania (embedding), čo môže trvať niekoľko minút. Model vkladania prevádza text na údaje, ktoré sa ľahšie vyhľadávajú a porovnávajú. Pred pokračovaním počkajte, kým sa zobrazí prihlasovacia stránka. Prvý zaregistrovaný účet sa stáva správcom. Jazyk rozhrania nasleduje jazyk systému; počas tohto testu sa zobrazila zjednodušená čínština.

DATA_DIR musí ukazovať na adresár, ktorý bude dlhodobo zachovaný a použitý na ukladanie údajov Open WebUI. Ak nie je nastavený, údaje môžu byť uložené v dočasnom adresári a po vypnutí stratené. Ak WEBUI_SECRET_KEY nie je nastavený, program zapíše .webui_secret_key do aktuálneho adresára. Spustite ho z adresára, ktorý chcete zachovať, alebo túto premennú nastavte sami.

Získanie podrobností o pripojení z OmniProxy

Skopírujte nasledujúce tri položky z vašej vlastnej inštancie OmniProxy:

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

URL je adresa, ktorú Open WebUI používa na pripojenie ku koncovému bodu a musí končiť na /v1. Nepridávajte /chat/completions za ňu; Open WebUI túto časť pripojí automaticky.

Skopírujte úplné ID modelu z aktuálneho zoznamu OmniProxy. Ak ID obsahuje predponu zdroja a lomku, zachovajte ich tiež. Nasledujúce dva krátke názvy sú len referencie z dokumentácie poskytovateľa k 9. 10. 2026. Nepoužívajte ich, ak nie sú v aktuálnom zozname:

• Claude API ID pre Claude Sonnet 5.5: claude-sonnet-5-5
• API názov pre Gemini 3.8 Flash: gemini-3.8-flash

Nezadávajte kľúč poskytovateľa v Open WebUI. Ak brána kľúče neoveruje, ponechajte API kľúč prázdny namiesto vymýšľania iného kľúča.

Prehliadač

Lokálny port 3000

• Otvorte stránku chatu
• Najprv dokončite registráciu
• Potom otvorte nastavenia

Vo vnútri kontajnera

Open WebUI

• Nepoužívajte localhost
• Namiesto toho použite názov hostiteľského počítača
• URL končí na /v1

Rovnaký počítač

OmniProxy

• Ponechajte kľúč v bráne
• Použite zoznam modelov brány
• Potom skontrolujte denníky požiadaviek

Ak modelová služba beží na hostiteľovi, zatiaľ čo Open WebUI beží v kontajneri Docker, nahraďte localhost v URL za host.docker.internal. Hostiteľ je počítač, na ktorom Docker beží priamo. Ak OmniProxy počúva iba v tomto počítači, URL možno napísať ako http://host.docker.internal:port/v1, nahradením port portom, ktorý OmniProxy skutočne používa.

Ak Open WebUI beží lokálne cez príkaz Pythonu v predchádzajúcej časti a OmniProxy tiež beží lokálne, použite 127.0.0.1 alebo localhost v adrese. Nepoužívajte host.docker.internal v tomto prípade.

Zadanie konfigurácie

V rozhraní v zjednodušenej čínštine verzie v0.11.4 testovanej 9. 10. 2026 sa názvy líšili od Settings > Admin > Connections v anglických pokynoch. Postupujte podľa možností zobrazených v testovanom rozhraní, preložených nižšie:

1. Rozbaľte ľavý bočný panel.
2. Kliknite na ponuku používateľa v spodnej časti.
3. Kliknite na Settings.
4. V sekcii správcu nižšie kliknite na External Connections.
5. Otvorte OpenAI API.
6. Kliknite na + napravo od Manage OpenAI API Connections.
7. V dialógovom okne Edit Connection zadajte URL končiacu na /v1. Ponechajte typ API nastavený na Chat Completions.
8. Ponechajte Authentication Method nastavenú na Key (Bearer). Autentizácia Bearer umiestni API kľúč do požiadavky na overenie identity. Ak vám OmniProxy poskytlo kľúč, zadajte ho pod API Key. Ak brána kľúče neoveruje, ponechajte toto pole prázdne. Dňa 9. 10. 2026 bolo overenie aj jedna konverzácia úspešná s ponechaním prázdneho poľa.
9. Kliknite na Verify Connection vedľa URL. Ak OmniProxy poskytuje /models, zoznam modelov sa načíta tu.
10. Otvorte Advanced. Ak zostane Model ID prázdne, použijú sa všetky modely vrátené /models na danej adrese. Iba ak overenie zlyhá, zadajte úplné ID zo zoznamu pod Add Model ID, potom kliknite na Add. Každé ID pridajte iba raz; úvodné a koncové medzery sa odstránia.
11. Kliknite na Save v tomto okne, potom kliknite na Save v pravom dolnom rohu stránky External Connections.

Samotné uloženie konfigurácie nenahrádza overenie. Verify Connection vyžaduje koncový bod /models druhej služby, ktorý uvádza dostupné modely. Niektoré služby tento koncový bod neposkytujú, takže overenie môže nahlásiť chybu, hoci chat môže stále fungovať. V takom prípade pridajte ID modelu manuálne.

Overenie skutočnej úlohy

Vráťte sa na stránku chatu, otvorte ponuku modelov vedľa vstupného poľa a vyberte úplné ID zo zoznamu OmniProxy. Odošlite veľmi krátku správu, napríklad požiadajte ho, aby odpovedal iba jedným slovom. Odpoveď sa musí skutočne zobraziť v okne chatu.

Dňa 9. 10. 2026 bola táto konverzácia dokončená pomocou inštalácie Pythonu verzie v0.11.4. Docker zostáva odporúčanou metódou, ale test sa v Dockeri neopakoval.

Ďalej otvorte denníky požiadaviek OmniProxy a potvrďte zdroj a ID modelu pre túto požiadavku. Vidieť iba úspešné uloženie alebo vidieť model v ponuke sa nepočíta ako dokončenie.

Rozhranie

Model možno vybrať

• Connections boli uložené
• Model sa zobrazí v zozname
• Odošlite krátku otázku

Odpoveď

Okno chatu zobrazuje odpoveď

• Nie je to prázdna správa
• Nie je to chyba pripojenia
• Skúste to znova s iným modelom

Denníky (Logs)

Viditeľné v bráne

• Zdrojom je toto pripojenie
• ID modelu sa zhoduje
• Na stránke nebol zadaný žiadny kľúč

Bežné chyby

• localhost alebo 127.0.0.1 boli použité vo vnútri kontajnera: Tieto adresy ukazujú na samotný kontajner, nie na hostiteľa. Zmeňte adresu na host.docker.internal a potvrďte, že príkaz na spustenie obsahuje --add-host=host.docker.internal:host-gateway. Opačné platí, keď Open WebUI nebeží v kontajneri: použite namiesto toho lokálnu adresu.
• Prehliadač nemôže otvoriť stránku: Pre Docker skontrolujte port 3000; pre Python skontrolujte port 8080. Počas prvého spustenia počkajte na dokončenie sťahovania modelu vkladania. Môžete použiť docker ps na potvrdenie, či kontajner beží. Ak je port 3000 už obsadený, zmeňte port na ľavej strane -p.
• ID v ponuke modelov je dlhšie ako krátky názov poskytovateľa: Použite úplné ID z ponuky, vrátane všetkých lomiek.
• Všetci sú po aktualizácii odhlásení: WEBUI_SECRET_KEY zmenené. Reštartujte pomocou tajného kľúča vygenerovaného pri prvom spustení.
• Verify Connection zlyhá: Najprv manuálne pridajte ID modelu pod Advanced, potom ho potvrďte skutočným chatom na jednu vetu. Niektoré služby neposkytujú /models, takže chat môže stále fungovať, aj keď overenie nahlási chybu.
• Model neexistuje: Skopírujte ID znova z aktuálneho zoznamu OmniProxy namiesto pokračovania v používaní zastaraného názvu.

Oficiálne referencie

Pre inštalačné príkazy pozri Open WebUI Quick Start. Pre kroky pripojenia pozri OpenAI-compatible connection instructions. Pre ID modelov použité v príkladoch pozri Claude model overview a Gemini model list.

Nahraďte každú zástupnú hodnotu hodnotami z vašej vlastnej konfigurácie OmniProxy. Nikdy nezverejňujte skutočný kľúč.

Uložený výsledok alebo HTTP 200 sám o sebe nepreukazuje plnú kompatibilitu Agentov. Skontrolujte zdroj a model v zázname volania OmniProxy.

Oficiálne zdroje · Open WebUI ↗