Instalacija Open WebUI-a i konfiguracija OmniProxy-a

Open WebUI je samostalno hostirano sučelje za chat koje se može instalirati na vaše računalo ili poslužitelj, a može raditi i potpuno izvan mreže. Nije vezano za jednog pružatelja modela: može se povezati s alatima kao što je Ollama koji pokreću modele lokalno, kao i s krajnjim točkama kompatibilnim s OpenAI-om—adresama koje pružaju usluge modela koristeći isti format zahtjeva. To vam omogućuje prebacivanje između lokalnih i cloud modela u istom prozoru.

Prikladan je za dugotrajnu upotrebu od strane timova i organizacija. Mogućnosti koje primaju brža ažuriranja pojavljuju se prvo u Computer-u, proizvodu koji Open WebUI koristi za isprobavanje novih značajki.

Prije početka

Open WebUI je dostupan na macOS-u, Linuxu i Windowsima. Možete ga instalirati koristeći Docker, Python ili Kubernetes. Docker pakira aplikaciju i njezino runtime okruženje u relativno izolirani spremnik (container) i preporučena je metoda. Ako Docker nije dostupan, možete koristiti i testiranu Python naredbu u nastavku. Kubernetes je sustav za implementaciju i upravljanje spremnicima; pogledajte Quick Start povezan na kraju ovog vodiča za odgovarajuće korake.

Službeno preporučeno

Docker

• Jedna docker run naredba
• Otvorite 3000 u pregledniku
• Podaci su pohranjeni u volumenu

Samo želite chatati

slim slika

• Manja veličina preuzimanja
• Promijenite oznaku u :slim
• Funkcionalnost chata ostaje dostupna

Nije ovdje obuhvaćeno

Dvije druge opcije

• Ručna instalacija Pythona
• Kubernetes implementacija
• Pogledajte službeni Quick Start

Prije početka pripremite sljedeće:

• Docker instaliran i pokrenut.
• Tajni niz koji koristite samo vi. Pokrenite openssl rand -hex 32 da biste ga generirali, zatim ga unesite kao WEBUI_SECRET_KEY. Trajno spremite ovu vrijednost. Ako je promijenite prilikom ponovne izgradnje spremnika, korisnici koji su već prijavljeni bit će odjavljeni.
• Pokrenutu instancu OmniProxy-a i ID modela s njegovog trenutnog popisa modela. ID modela je potpuno ime koje se koristi za odabir određenog modela.

Instalacija i prvo pokretanje

Otvorite terminal i pokrenite naredbu iz Quick Start-a. Prvo zamijenite your-secret-key tajnom koju ste upravo generirali:

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

Sljedeći dijelovi ove naredbe služe različitim svrhama:

• -p 3000:8080: Omogućuje otvaranje sučelja putem porta 3000 na ovom računalu. Ako je port 3000 već u upotrebi, promijenite broj s lijeve strane.
• -v open-webui:/app/backend/data: Pohranjuje chatove, korisnike i postavke u podatkovni volumen. Podatkovni volumen je lokacija izvan spremnika gdje se podaci dugoročno zadržavaju, tako da njihov sadržaj ostaje nakon ažuriranja spremnika. Nemojte uklanjati ovu opciju.
• --add-host=host.docker.internal:host-gateway: Omogućuje spremniku pristup drugim uslugama koje rade na ovom računalu.
• --restart always: Ponovno pokreće spremnik nakon ponovnog pokretanja računala.

Nakon što naredba završi, otvorite http://localhost:3000 u pregledniku i slijedite upute na zaslonu za stvaranje prvog računa.

Ako trebate chatati samo putem API-ja, možete promijeniti oznaku slike iz :main u :slim. slim je manja slika koja ne uključuje lokalne modele govora i ugradnje (embedding) unutar spremnika, ali sučelje za chat ostaje dostupno. Nastavite koristiti :main ako trebate te lokalne mogućnosti.

Za ručna ažuriranja, prvo pokrenite docker rm -f open-webui, zatim pokrenite docker pull ghcr.io/open-webui/open-webui:main, i ponovno ga pokrenite s istom docker run naredbom. Zadržite i podatkovni volumen i WEBUI_SECRET_KEY nepromijenjenima.

Ako Docker nije dostupan

Quick Start također nudi metodu instalacije Pythona. 09.10.2026., sljedeća naredba korištena je na macOS-u za instalaciju Open WebUI v0.11.4 i dovršetak jednog razgovora. Docker Desktop u to vrijeme nije bio instaliran na tom računalu.

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

Nakon pokretanja, otvorite http://localhost:8080 u pregledniku. Ovo je port koji koristi Python instalacija, a ne Dockerov port 3000.

Model ugradnje (embedding model) preuzima se tijekom prvog pokretanja, što može potrajati nekoliko minuta. Model ugradnje pretvara tekst u podatke koje je lakše pretraživati i podudarati. Pričekajte da se pojavi stranica za prijavu prije nastavka. Prvi registrirani račun postaje administrator. Jezik sučelja prati jezik sustava; tijekom ovog testa prikazan je pojednostavljeni kineski.

DATA_DIR mora pokazivati na direktorij koji će se dugoročno zadržati i koristiti za pohranu podataka Open WebUI-a. Ako nije postavljen, podaci se mogu pohraniti u privremeni direktorij i izgubiti nakon isključivanja. Ako WEBUI_SECRET_KEY nije postavljen, program piše .webui_secret_key u trenutnom direktoriju. Pokrenite ga iz direktorija koji namjeravate zadržati ili sami postavite ovu varijablu.

Dohvaćanje detalja povezivanja iz OmniProxy-a

Kopirajte sljedeće tri stavke iz vlastite instance OmniProxy-a:

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 koju Open WebUI koristi za povezivanje s krajnjom točkom i mora završavati s /v1. Nemojte dodavati /chat/completions nakon njega; Open WebUI automatski dodaje taj dio.

Kopirajte potpuni ID modela s trenutnog popisa OmniProxy-a. Ako ID uključuje prefiks izvora i kosu crtu, zadržite i njih. Sljedeća dva kratka imena su samo reference iz dokumentacije pružatelja usluga od 09.10.2026. Nemojte ih koristiti ako nisu na trenutnom popisu:

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

Nemojte unositi ključ pružatelja u Open WebUI. Ako gateway ne provjerava ključeve, ostavite API ključ praznim umjesto izmišljanja drugog ključa.

Preglednik

Lokalni port 3000

• Otvorite stranicu za chat
• Prvo dovršite registraciju
• Zatim otvorite postavke

Unutar spremnika

Open WebUI

• Nemojte koristiti localhost
• Umjesto toga koristite ime host stroja
• URL završava s /v1

Isto računalo

OmniProxy

• Zadržite ključ u gateway-u
• Koristite popis modela gateway-a
• Zatim pregledajte zapise zahtjeva

Ako usluga modela radi na hostu dok Open WebUI radi u Docker spremniku, zamijenite localhost u URL-u s host.docker.internal. Host je računalo koje izravno pokreće Docker. Ako OmniProxy sluša samo na ovom računalu, URL se može napisati kao http://host.docker.internal:port/v1, zamjenjujući port portom koji OmniProxy zapravo koristi.

Ako Open WebUI radi lokalno putem Python naredbe u prethodnom odjeljku, a OmniProxy također radi lokalno, koristite 127.0.0.1 ili localhost u adresi. Nemojte koristiti host.docker.internal u ovom slučaju.

Unos konfiguracije

U sučelju na pojednostavljenom kineskom jeziku v0.11.4 testiranom 09.10.2026., imena su se razlikovala od Postavke > Administrator > Povezivanja u engleskim uputama. Slijedite opcije prikazane u testiranom sučelju, prevedene u nastavku:

1. Proširite lijevu bočnu traku.
2. Kliknite korisnički izbornik na dnu.
3. Kliknite Postavke.
4. U odjeljku administratora ispod, kliknite Vanjska povezivanja.
5. Otvorite OpenAI API.
6. Kliknite + desno od Upravljanje OpenAI API povezivanjima.
7. U dijaloškom okviru Uredi povezivanje, unesite URL koji završava s /v1. Zadržite vrstu API-ja postavljenu na Chat Completions.
8. Zadržite Način provjere autentičnosti postavljen na Ključ (Bearer). Bearer provjera autentičnosti stavlja API ključ u zahtjev za provjeru identiteta. Ako vam je OmniProxy dao ključ, unesite ga pod API ključ. Ako gateway ne provjerava ključeve, ostavite ovo polje praznim. 09.10.2026., i provjera i jedan razgovor uspjeli su s poljem ostavljenim praznim.
9. Kliknite Provjeri povezivanje pored URL-a. Ako OmniProxy pruža /models, popis modela će se dohvatiti ovdje.
10. Otvorite Napredno. Ako je ID modela ostavljen praznim, koristit će se svi modeli koje vraća /models na toj adresi. Samo ako provjera ne uspije, unesite potpuni ID s popisa pod Dodaj ID modela, zatim kliknite Dodaj. Dodajte svaki ID samo jednom; vodeći i prateći razmaci se uklanjaju.
11. Kliknite Spremi u ovom prozoru, zatim kliknite Spremi u donjem desnom kutu stranice Vanjska povezivanja.

Samo spremanje konfiguracije ne zamjenjuje provjeru. Provjeri povezivanje zahtijeva krajnju točku /models druge usluge, koja navodi dostupne modele. Neke usluge ne pružaju ovu krajnju točku, pa provjera može prijaviti pogrešku iako chat i dalje može raditi. U tom slučaju, ručno dodajte ID modela.

Provjera stvarnog zadatka

Vratite se na stranicu za chat, otvorite izbornik modela pored okvira za unos i odaberite potpuni ID s popisa OmniProxy-a. Pošaljite vrlo kratku poruku, kao što je zahtjev da odgovori samo jednom riječju. Odgovor se mora stvarno pojaviti u okviru za chat.

09.10.2026., ovaj razgovor je dovršen koristeći Python instalaciju v0.11.4. Docker ostaje preporučena metoda, ali test nije ponovljen u Dockeru.

Zatim otvorite zapise zahtjeva OmniProxy-a i potvrdite izvor i ID modela za ovaj zahtjev. Vidjeti samo uspješno spremanje, ili samo vidjeti model u izborniku, ne računa se kao dovršetak.

Sučelje

Model se može odabrati

• Povezivanja su spremljena
• Model se pojavljuje na popisu
• Pošaljite kratko pitanje

Odgovor

Okvir za chat prikazuje odgovor

• Nije prazna poruka
• Nije pogreška povezivanja
• Pokušajte ponovno s drugim modelom

Zapisnici

Vidljivo u gateway-u

• Izvor je ovo povezivanje
• ID modela se podudara
• Na stranici nije unesen ključ

Uobičajene pogreške

• localhost ili 127.0.0.1 korišteni su unutar spremnika: Ove adrese pokazuju na sam spremnik, a ne na host. Promijenite adresu u host.docker.internal i potvrdite da naredba za pokretanje uključuje --add-host=host.docker.internal:host-gateway. Obrnuto vrijedi kada Open WebUI ne radi u spremniku: umjesto toga koristite lokalnu adresu.
• Preglednik ne može otvoriti stranicu: Za Docker, provjerite port 3000; za Python, provjerite port 8080. Tijekom prvog pokretanja, pričekajte da se preuzimanje modela ugradnje završi. Možete koristiti docker ps da biste potvrdili radi li spremnik. Ako je port 3000 već u upotrebi, promijenite port na lijevoj strani -p.
• ID u izborniku modela duži je od kratkog imena pružatelja: Koristite potpuni ID iz izbornika, uključujući sve kose crte.
• Svi su odjavljeni nakon ažuriranja: WEBUI_SECRET_KEY promijenjeno. Ponovno pokrenite koristeći tajnu generiranu prvi put.
• Provjeri povezivanje ne uspijeva: Prvo ručno dodajte ID modela pod Napredno, zatim ga potvrdite stvarnim chatom od jedne rečenice. Neke usluge ne pružaju /models, pa chat može i dalje raditi kada provjera prijavi pogrešku.
• Model ne postoji: Kopirajte ID ponovno s trenutnog popisa OmniProxy-a umjesto da nastavite koristiti zastarjelo ime.

Službene reference

Za naredbe instalacije, pogledajte Open WebUI Quick Start. Za korake povezivanja, pogledajte OpenAI-compatible connection instructions. Za ID-ove modela korištene u primjerima, pogledajte Claude model overview i Gemini model list.

Zamijenite svaki predložak vrijednostima iz vlastite OmniProxy konfiguracije. Nikada ne objavite stvarni ključ.

Spremljeni rezultat ili HTTP 200 sami po sebi ne dokazuju punu kompatibilnost Agenta. Provjerite izvor i model u zapisu poziva OmniProxy.

Službeni izvori · Open WebUI ↗