Instalace Open WebUI a konfigurace OmniProxy

Open WebUI je self-hosted chatovací rozhraní, které lze nainstalovat do vlastního počítače nebo serveru a může běžet i zcela offline. Není vázáno na žádného konkrétního poskytovatele modelů: může se připojit k nástrojům, jako je Ollama, které spouštějí modely lokálně, stejně jako ke koncovým bodům kompatibilním s OpenAI – adresám, které poskytují modelové služby pomocí stejného formátu požadavků. To vám umožní přepínat mezi lokálními a cloudovými modely ve stejném okně.

Je vhodné pro dlouhodobé používání týmy a organizacemi. Funkce, které dostávají rychlejší aktualizace, se nejprve objevují v Computer, produktu, který Open WebUI používá k vyzkoušení nových funkcí.

Než začnete

Open WebUI je k dispozici na macOS, Linuxu a Windows. Můžete jej nainstalovat pomocí Dockeru, Pythonu nebo Kubernetes. Docker balí aplikaci a její běhové prostředí do relativně izolovaného kontejneru a je doporučenou metodou. Pokud Docker není k dispozici, můžete použít také níže uvedený testovaný příkaz Pythonu. Kubernetes je systém pro nasazování a správu kontejnerů; viz Rychlý start propojený na konci této příručky pro odpovídající kroky.

Oficiálně doporučeno

Docker

• Jeden příkaz docker run
• Otevřete 3000 v prohlížeči
• Data jsou uložena ve svazku

Chci jen chatovat

slim image

• Menší velikost stahování
• Změňte tag na :slim
• Funkce chatu zůstává dostupná

Zde nepokryto

Dvě další možnosti

• Manuální instalace Pythonu
• Nasazení Kubernetes
• Viz oficiální Rychlý start

Před zahájením si připravte následující:

• Docker nainstalovaný a běžící.
• Tajný řetězec používaný pouze vámi. Spusťte openssl rand -hex 32 pro vygenerování jednoho, poté jej zadejte jako WEBUI_SECRET_KEY. Tuto hodnotu uložte trvale. Pokud ji při opětovném sestavení kontejneru změníte, uživatelé, kteří jsou již přihlášeni, budou odhlášeni.
• Běžící instanci OmniProxy a ID modelu z jejího aktuálního seznamu modelů. ID modelu je úplný název používaný k výběru konkrétního modelu.

Instalace a první spuštění

Otevřete terminál a spusťte příkaz z Rychlého startu. Nejprve nahraďte your-secret-key tajemstvím, které jste právě 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

Následující části tohoto příkazu slouží k různým účelům:

• -p 3000:8080: Umožňuje otevřít rozhraní přes port 3000 v tomto počítači. Pokud je port 3000 již používán, změňte číslo vlevo.
• -v open-webui:/app/backend/data: Ukládá chaty, uživatele a nastavení do datového svazku. Datový svazek je umístění mimo kontejner, kde jsou data dlouhodobě uchovávána, takže jejich obsah zůstane i po aktualizaci kontejneru. Tuto možnost neodstraňujte.
• --add-host=host.docker.internal:host-gateway: Umožňuje kontejneru přístup k dalším službám běžícím v tomto počítači.
• --restart always: Restartuje kontejner po restartu počítače.

Po dokončení příkazu otevřete http://localhost:3000 v prohlížeči a postupujte podle pokynů na obrazovce pro vytvoření prvního účtu.

Pokud potřebujete chatovat pouze přes API, můžete změnit tag image z :main na :slim. slim je menší image, která neobsahuje lokální modely řeči a vkládání (embedding) uvnitř kontejneru, ale chatovací rozhraní zůstává dostupné. Pokračujte v používání :main pokud tyto lokální schopnosti potřebujete.

Pro manuální aktualizace nejprve spusťte docker rm -f open-webui, poté spusťte docker pull ghcr.io/open-webui/open-webui:main, a restartujte jej stejným docker run příkazem. Ponechte datový svazek i WEBUI_SECRET_KEY beze změny.

Pokud Docker není k dispozici

Rychlý start také poskytuje metodu instalace Pythonu. Dne 9. 10. 2026 byl na macOS použit následující příkaz k instalaci Open WebUI v0.11.4 a dokončení jedné konverzace. Docker Desktop v té době v počítači nebyl nainstalován.

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

Po spuštění otevřete http://localhost:8080 v prohlížeči. Toto je port používaný instalací Pythonu, nikoliv port 3000 Dockeru.

Během prvního spuštění se stáhne model pro vkládání (embedding), což může trvat několik minut. Model pro vkládání převádí text na data, která se snadněji vyhledávají a porovnávají. Před pokračováním počkejte, až se objeví přihlašovací stránka. První registrovaný účet se stane správcem. Jazyk rozhraní následuje jazyk systému; během tohoto testu byla zobrazena zjednodušená čínština.

DATA_DIR musí ukazovat na adresář, který bude dlouhodobě zachován a použit k ukládání dat Open WebUI. Pokud není nastaven, data mohou být uložena v dočasném adresáři a po vypnutí ztracena. Pokud WEBUI_SECRET_KEY není nastaven, program zapíše .webui_secret_key v aktuálním adresáři. Spusťte jej z adresáře, který hodláte zachovat, nebo si tuto proměnnou nastavte sami.

Získání podrobností o připojení z OmniProxy

Zkopírujte následující tři položky z vaší vlastní instance 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, kterou Open WebUI používá k připojení ke koncovému bodu, a musí končit /v1. Nepřidávejte /chat/completions za ni; Open WebUI tuto část připojí automaticky.

Zkopírujte celé ID modelu z aktuálního seznamu OmniProxy. Pokud ID obsahuje prefix zdroje a lomítko, zachovejte je také. Následující dva krátké názvy jsou pouze reference z dokumentace poskytovatele k 9. 10. 2026. Nepoužívejte je, pokud nejsou v aktuálním seznamu:

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

Nezadávejte klíč poskytovatele v Open WebUI. Pokud gateway klíče neověřuje, ponechte API klíč prázdný, místo abyste vymýšleli jiný klíč.

Prohlížeč

Lokální port 3000

• Otevřete stránku chatu
• Nejprve dokončete registraci
• Poté otevřete nastavení

Uvnitř kontejneru

Open WebUI

• Nepoužívejte localhost
• Místo toho použijte název hostitelského počítače
• URL končí /v1

Stejný počítač

OmniProxy

• Ponechte klíč v gateway
• Použijte seznam modelů gateway
• Poté zkontrolujte logy požadavků

Pokud modelová služba běží na hostiteli, zatímco Open WebUI běží v kontejneru Docker, nahraďte localhost v URL za host.docker.internal. Hostitel je počítač, na kterém běží Docker přímo. Pokud OmniProxy naslouchá pouze v tomto počítači, URL lze zapsat jako http://host.docker.internal:port/v1, nahrazením port portem, který OmniProxy skutečně používá.

Pokud Open WebUI běží lokálně prostřednictvím příkazu Pythonu v předchozí části a OmniProxy také běží lokálně, použijte 127.0.0.1 nebo localhost v adrese. V tomto případě nepoužívejte host.docker.internal .

Zadání konfigurace

V rozhraní v0.11.4 testovaném dne 9. 10. 2026 se názvy lišily od Settings > Admin > Connections v anglických pokynech. Postupujte podle možností zobrazených v testovaném rozhraní, přeložených níže:

1. Rozbalte levý postranní panel.
2. Klikněte na uživatelské menu dole.
3. Klikněte na Settings.
4. V sekci správce níže klikněte na External Connections.
5. Otevřete OpenAI API.
6. Klikněte na + napravo od Manage OpenAI API Connections.
7. V dialogu Edit Connection zadejte URL končící /v1. Ponechte typ API nastavený na Chat Completions.
8. Ponechte Authentication Method nastavenou na Key (Bearer). Autentizace Bearer vkládá API klíč do požadavku pro ověření identity. Pokud vám OmniProxy poskytlo klíč, zadejte jej pod API Key. Pokud gateway klíče neověřuje, ponechte toto pole prázdné. Dne 9. 10. 2026 proběhlo ověření i jedna konverzace úspěšně s ponecháním pole prázdného.
9. Klikněte na Verify Connection vedle URL. Pokud OmniProxy poskytuje /models, seznam modelů bude načten zde.
10. Otevřete Advanced. Pokud je Model ID ponecháno prázdné, budou použity všechny modely vrácené /models na dané adrese. Pouze pokud ověření selže, zadejte úplné ID ze seznamu pod Add Model ID, poté klikněte na Add. Každé ID přidejte pouze jednou; úvodní a koncové mezery jsou odstraněny.
11. Klikněte na Save v tomto okně, poté klikněte na Save v pravém dolním rohu stránky External Connections.

Samotné uložení konfigurace nenahrazuje ověření. Verify Connection požaduje koncový bod /models druhé služby, který vypisuje dostupné modely. Některé služby tento koncový bod neposkytují, takže ověření může nahlásit chybu, i když chat může stále fungovat. V takovém případě přidejte ID modelu ručně.

Ověření skutečným úkolem

Návrat na stránku chatu, otevřete menu modelů vedle vstupního pole a vyberte úplné ID ze seznamu OmniProxy. Odešlete velmi krátkou zprávu, například požádejte o odpověď pouze jedním slovem. V chatovacím okně se musí skutečně objevit odpověď.

Dne 9. 10. 2026 byla tato konverzace dokončena pomocí instalace Pythonu v0.11.4. Docker zůstává doporučenou metodou, ale test nebyl v Dockeru opakován.

Poté otevřete logy požadavků OmniProxy a potvrďte zdroj a ID modelu pro tento požadavek. Vidět pouze úspěšné uložení, nebo vidět model pouze v menu, se nepočítá jako dokončení.

Rozhraní

Model lze vybrat

• Connections bylo uloženo
• Model se objeví v seznamu
• Odešlete krátkou otázku

Odpověď

Chatovací okno zobrazuje odpověď

• Není to prázdná zpráva
• Není to chyba připojení
• Zkuste to znovu s jiným modelem

Logy

Viditelné v gateway

• Zdroj je toto připojení
• ID modelu souhlasí
• Na stránce nebyl zadán žádný klíč

Běžné chyby

• localhost nebo 127.0.0.1 bylo použito uvnitř kontejneru: Tyto adresy ukazují na samotný kontejner, nikoliv na hostitele. Změňte adresu na host.docker.internal a potvrďte, že spouštěcí příkaz obsahuje --add-host=host.docker.internal:host-gateway. Opačně to platí, když Open WebUI neběží v kontejneru: použijte místo toho lokální adresu.
• Prohlížeč nemůže otevřít stránku: Pro Docker zkontrolujte port 3000; pro Python zkontrolujte port 8080. Během prvního spuštění počkejte na dokončení stahování modelu pro vkládání. Můžete použít docker ps k potvrzení, zda kontejner běží. Pokud je port 3000 již používán, změňte port na levé straně -p.
• ID v menu modelů je delší než krátký název poskytovatele: Použijte úplné ID z menu, včetně všech lomítek.
• Všichni jsou po aktualizaci odhlášeni: WEBUI_SECRET_KEY změněno. Restartujte pomocí tajemství vygenerovaného poprvé.
• Verify Connection selže: Nejprve ručně přidejte ID modelu pod Advanced, poté jej potvrďte skutečným chatem o jedné větě. Některé služby neposkytují /models, takže chat může stále fungovat, i když ověření nahlásí chybu.
• Model neexistuje: Zkopírujte ID znovu z aktuálního seznamu OmniProxy, místo abyste nadále používali zastaralý název.

Oficiální reference

Pro instalační příkazy viz Open WebUI Quick Start. Pro kroky připojení viz OpenAI-compatible connection instructions. Pro ID modelů použitá v příkladech viz Claude model overview a Gemini model list.

Nahraďte všechna záložní místa hodnotami z vlastní konfigurace OmniProxy. Nikdy nezveřejňujte skutečný klíč.

Uložený výsledek nebo HTTP 200 samo o sobě nedokazuje plnou kompatibilitu agenta. Zkontrolujte zdroj a model v záznamu požadavku OmniProxy.

Oficiální zdroje · Open WebUI ↗