Instalarea Open WebUI cu Docker (docker run) în Open WebUI & RAG Local

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=cheia-ta --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Docker este metoda recomandată oficial, pe macOS, Linux (x86_64 și ARM64) și Windows. Comanda descarcă imaginea ghcr.io/open-webui/open-webui:main și o pornește în fundal. În container aplicația ascultă pe portul 8080, iar -p 3000:8080 o face accesibilă la http://localhost:3000. Prima pornire durează aproximativ un minut; docker logs -f open-webui arată când apare Application startup complete.

Volumul open-webui, montat în /app/backend/data, păstrează baza de date webui.db, fișierele încărcate, baza vectorială și cache-ul; fără el, datele dispar la recrearea containerului. --add-host=host.docker.internal:host-gateway permite containerului să ajungă la serviciile de pe calculatorul gazdă, de exemplu la Ollama pe portul 11434. WEBUI_SECRET_KEY semnează sesiunile și criptează date sensibile; documentația o cere acum în comandă, generată o singură dată cu openssl rand -hex 32, pentru că fără o cheie fixă fiecare recreare a containerului deconectează toți utilizatorii.

Primul ecran oferă Create Admin Account: primul cont este administratorul instanței. După crearea lui înregistrările se opresc; alte persoane pot intra după ce administratorul pornește New Sign Ups în Settings > Admin > Authentication, iar conturile noi rămân Pending până la aprobare. Open WebUI nu are modele proprii: urmează conectarea la Ollama sau la un furnizor compatibil OpenAI. Fără Docker, instalarea Python este pip install open-webui urmat de open-webui serve (Python 3.11 sau 3.12; interfața la portul 8080).

Concepte cheie și caracteristici

Concept / Parametru	Descriere practică
-p 3000:8080	Portul 3000 al gazdei către portul 8080 din container. Dacă 3000 e ocupat, schimbi doar numărul din stânga.
-v open-webui:/app/backend/data	Volumul cu chaturile, utilizatorii, setările și fișierele. Rămâne la actualizări; containerul nu se rulează fără el.
--add-host=host.docker.internal:host-gateway	Face numele host.docker.internal să indice gazda; necesar pe Linux.
-e WEBUI_SECRET_KEY=...	Cheie fixă pentru sesiuni și criptare; se setează o dată și se păstrează la actualizări.
--restart always	Containerul repornește după un reboot.
:main / :latest	Aceeași imagine, reconstruită la fiecare modificare pe ramura main. :latest nu indică ultima versiune stabilă.
:vX.Y.Z	Versiune fixă, care nu se mai schimbă (de exemplu :v0.12.4); recomandată în producție. :X.Y urmează ultimul patch al seriei.
:slim	Fără stiva locală de machine learning (embeddings, Whisper, extragere de documente): în măsurătoarea documentației din 16 octombrie 2026, aproximativ 197 MB la descărcare față de 1,62 GB pentru :main (Linux/amd64). RAG, voce și PDF-uri cer atunci servicii externe.
:cuda / :ollama / :dev	Variante cu suport NVIDIA, cu Ollama inclus, respectiv versiunea de pre-lansare.
-e WEBUI_AUTH=False	Mod cu un singur utilizator, fără autentificare; posibil doar pe o instalare nouă și nu se mai poate trece înapoi.

Exemple practice și scenarii reale

Exemplul 1: Instalarea standard

Cheia se generează o singură dată și se refolosește la fiecare docker run ulterior.

openssl rand -hex 32
# copiezi rezultatul în locul lui cheia-ta

docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  -e WEBUI_SECRET_KEY=cheia-ta \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

docker logs -f open-webui

Exemplul 2: Actualizare manuală

Datele rămân în volum; documentația recomandă un backup înainte de fiecare actualizare și golirea cache-ului browserului după.

docker rm -f open-webui
docker pull ghcr.io/open-webui/open-webui:main
docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  -e WEBUI_SECRET_KEY=cheia-ta \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

Exemplul 3: Instalare cu Python

DATA_DIR alege directorul de date, iar --port portul.

pip install open-webui
DATA_DIR=~/.open-webui open-webui serve --port 3000

Greșeli frecvente și capcane

• Rulezi containerul fără -v. După docker rm sau o actualizare pierzi toate conturile și conversațiile.
• Folosești :main sau :latest în producție. Documentația recomandă o versiune fixă și citirea notelor de lansare: o migrare de bază de date nu se anulează prin revenirea la imaginea veche.
• Ollama rulează pe gazdă, dar ascultă doar pe 127.0.0.1, iar lista de modele rămâne goală. Ollama trebuie să asculte pe 0.0.0.0 (OLLAMA_HOST=0.0.0.0) când Open WebUI rulează în Docker.

Noțiuni și module înrudite

• docker-gpu-open-webui
• docker-compose-ollama-webui
• conectare-ollama-api
• open-webui-variabile-mediu