WEBUI

Open WebUI & RAG Local: instalare Docker, RAG local și administrare

15 ghiduri & opțiuni 5 categorii

Open WebUI (fostul Ollama WebUI) este cea mai avansată interfață grafică web self-hosted pentru modelele de inteligență artificială, oferind o experiență similară sau superioară celei din ChatGPT, dar care rulează în totalitate pe propria ta infrastructură.

Dincolo de un simplu ecran de chat, Open WebUI este un ecosistem complet: oferă sistem RAG nativ pe documente (PDF, Office, cod), suport pentru căutare web în timp real, autentificare cu roluri de utilizatori (RBAC), sinteză și transcriere vocală, și posibilitatea de a conecta sincron backend-uri Ollama, vLLM și chei de API din cloud.

Cum este organizat acest ghid

Am structurat cele 15 ghiduri, proceduri Docker și funcționalități cheie în 3 domenii esențiale:

Instalare, Docker & Conectare: docker run de bază, rulare cu suport GPU, docker-compose (Ollama + WebUI), conectare la Ollama API și conectare la vLLM/OpenAI.
RAG Local pe Documente Private: Încărcare documente cu tag-ul #, selectarea motorului de embeddings, reglarea Chunk Size & Overlap și căutare hibridă cu re-ranking.
Funcții Avansate & Administrare: Căutare web în timp real, gestionarea utilizatorilor și a permisiunilor (RBAC), descărcare modele din comunitate, unelte Python (Custom Tools), voce (Whisper/TTS) și proceduri de backup.

Apasă pe oricare ghid de mai jos pentru comenzi, pași detaliați de configurare și bune practici de securitate.

macOS • Windows • Linux

Ghid de instalare Open WebUI pe fiecare sistem de operare

Pornește interfața ta privată ChatGPT (conectată la Ollama și API-uri externe) prin Docker sau Python uv.

Cerințe de sistem: Docker Desktop / Docker Engine (recomandat) sau Python 3.11.

Terminal macOS (Homebrew / zsh)

# Varianta 1 (Recomandată): Cu Docker Desktop pe macOS (conectat la Ollama local)
docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

# Varianta 2 (Fără Docker, prin uvx cu Python 3.11):
brew install uv
DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

Windows 10 / 11 (PowerShell / Winget / WSL2)

# Varianta 1: În Docker Desktop (PowerShell)
docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway ` 
  -v open-webui:/app/backend/data --name open-webui --restart always ` 
  ghcr.io/open-webui/open-webui:main

# Varianta 2: Fără Docker (în PowerShell cu uv):
uvx --python 3.11 open-webui@latest serve
# Deschide în browser: http://localhost:8080 (sau :3000 pentru Docker)

Linux (Ubuntu / Debian / Bash)

# Pe Linux cu Docker Engine:
docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

# Dacă pe Linux containerul nu vede Ollama, adaugă --network=host:
docker run -d --network=host -v open-webui:/app/backend/data \
  -e OLLAMA_BASE_URL=http://127.0.0.1:11434 --name open-webui \
  ghcr.io/open-webui/open-webui:main

Autentificare & Configurare Chei API

# La prima accesare pe http://localhost:3000, primul cont creat devine automat Administrator!
# Pentru a adăuga chei OpenAI / Anthropic / OpenRouter:
# Mergi în Admin Panel -> Settings -> Connections -> OpenAI API.

Instalare, Docker & Conectare 5 ghiduri & opțiuni

RAG Local & Documente Private 4 ghiduri & opțiuni

Instrumente & Extensii 3 ghiduri & opțiuni

Securitate & Administrare 2 ghiduri & opțiuni

Conectare & Modele 1 ghid

Comunitatea Open WebUI (Modelfiles & Prompts) Explorare pe openwebui.com/models și descărcare directă prin butonul 'Get' Importul cu un singur click de personaje, asistenți de programare și șabloane de prompt create de comunitatea mondială.