Watch open-webui video
Watch open-webui video
open-webui
open-webui
OfficialDocker app from joly0's Repository
Overview
(Formerly Ollama WebUI)
ChatGPT-Style Web Interface for various LLM runners, including Ollama and OpenAI-compatible APIs
IMPORTANT: Make sure to add the following environment variable to your ollama container
- OLLAMA_ORIGINS=*
Set your OpenAI API key (not persistant)
- OPENAI_API_KEY
Readme
View on GitHubOpen WebUI
Open WebUI is a home for AI: an extensible, easy-to-use, self-hosted platform built to run entirely offline. Connect local models through Ollama or use OpenAI-compatible APIs for local and cloud models.
English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt
GitHub stars GitHub forks GitHub watchers GitHub repo size GitHub language count GitHub top language GitHub last commit Discord External image (view source)
Installation
Python
# With uv installed (macOS/Linux)
DATA_DIR=~/.open-webui uvx --python 3.12 open-webui@latest serve
# Or install and run with pip (Python 3.12)
pip install open-webui
open-webui serve
Then open http://localhost:8080.
Docker
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
Then open http://localhost:3000.
| Image tag | Includes |
|---|---|
:main |
Standard image with local AI dependencies |
:slim |
Lightweight image using external services for embeddings, document extraction, and voice |
:cuda |
Open WebUI with CUDA acceleration |
:ollama |
Open WebUI bundled with Ollama |
:dev |
Latest development build |
Add these options to docker run before the image name as needed:
| Option | Purpose |
|---|---|
-e OLLAMA_BASE_URL=http://your-ollama-server:11434 |
Connect to Ollama on another server |
-e OPENAI_API_KEY=your_secret_key |
Set your OpenAI API key |
-e HF_HUB_OFFLINE=1 |
Disable Hugging Face model downloads for offline use |
--gpus all |
Enable Nvidia GPU access for :cuda or :ollama; requires the Nvidia Container Toolkit |
See the Docker installation guide for setup instructions and configuration options.
Desktop App
Download the native desktop app for macOS, Windows, and Linux.
Ecosystem
- Open Terminal / Terminals (Enterprise): The action layer that turns Open WebUI into a full agent harness, with enterprise orchestration for per-user workspaces.
- Knowledge Base Sync (oikb): Mirror folders, repos, buckets, and wikis into Open WebUI Knowledge Bases with incremental sync.
- Open WebUI Computer: Your computer in any browser: files, editor, terminal, git, and optional AI agents, running on your real machine.
See the ecosystem documentation for details.
Troubleshooting and Updates
See the troubleshooting guide for connection issues and the updating guide to update your installation.
Documentation
See the docs for configuration and usage, and the roadmap for planned work.
For Docker Compose, Kubernetes, and other setups, see the installation docs.
Support
Open an issue or start a discussion.
Find us on Reddit, X, and Discord.
Security
Report vulnerabilities privately through GitHub security advisories. Security reports are accepted only through GitHub.
Star History
Star History ChartLicense
Includes code under the Open WebUI License, which requires preserving the Open WebUI branding, and prior contributions under their original licenses. See LICENSE and LICENSE_HISTORY for terms and history.
Enterprise · Careers · Sponsor
Created by Timothy Jaeryang Baek.
Categories
Related apps
Explore more like this
Explore allDetails
ghcr.io/open-webui/open-webui:mainRuntime arguments
- Web UI
http://[IP]:[PORT:8080]/- Network
bridge- Shell
bash- Privileged
- false
Template configuration
- Target
- /app/backend/data
- Default
- /mnt/user/appdata/open-webui
- Value
- /mnt/user/appdata/open-webui
Sets the port to run Open WebUI from.
- Target
- 8080
- Default
- 8080
- Value
- 8080
You MUST set WEBUI_SECRET_KEY to a secure, persistent value. Example command: openssl rand -base64 48
Enables the use of Ollama APIs.
- Default
- true|false
Configures the Ollama backend URL.
- Default
- http://localhost:11434
- Value
- http://localhost:11434
Enables the use of OpenAI APIs.
- Default
- true|false
Configures the OpenAI base API URL.
- Default
- https://api.openai.com/v1
- Value
- https://api.openai.com/v1
Sets the OpenAI API key, e.g. sk-124781258123.
This setting enables or disables authentication.
- Default
- true|false
Sets the allowed origins for Cross-Origin Resource Sharing (CORS). Smicolon ';' separated list of allowed origins.
- Default
- *
- Value
- *
Enables or disables channel support.
- Default
- false|true
Enables or disables the folders feature, allowing users to organize their chats into folders in the sidebar.
- Default
- true|false
Enables or disables the notes feature, allowing users to create and manage personal notes within Open WebUI.
- Default
- true|false
Enables or disables the memory feature, allowing models to store and retrieve long-term information about users.
- Default
- true|false
Enables admin users to directly access the chats of other users.
- Default
- true|false
Controls whether the Analytics tab is visible and accessible in the admin panel.
- Default
- true|false
Enables or disables easter egg features in the UI, such as special themes. Set to False to hide these optional novelty features from users.
- Default
- true|false
Sets the global logging level for all Open WebUI components.
- Default
- INFO|DEBUG|WARNING|ERROR|CRITICAL
Enables or disables evaluation arena models.
- Default
- true|false
Enables message rating feature.
- Default
- true|false
Controls whether users can share content with the Open WebUI Community and access community resources.
- Default
- true|false
Proxy for HTTP.
Proxy for HTTPS.
Comma-separate list of hosts/IPs that bypass the proxy.