Watch open-webui video

Watch open-webui video

open-webui

open-webui

open-webui

Official

Docker 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

Open 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

Open WebUI Demo

GitHub stars GitHub forks GitHub watchers GitHub repo size GitHub language count GitHub top language GitHub last commit Discord External image (view source)

Explore Open WebUI →

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.

Read the docs →

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 Chart

License

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.

Related apps

Details

Repository
ghcr.io/open-webui/open-webui:main
Last Updated2026-11-06
First Seen2024-04-21

Runtime arguments

Web UI
http://[IP]:[PORT:8080]/
Network
bridge
Shell
bash
Privileged
false

Template configuration

DataPathrw
Target
/app/backend/data
Default
/mnt/user/appdata/open-webui
Value
/mnt/user/appdata/open-webui
WebUI PortPorttcp

Sets the port to run Open WebUI from.

Target
8080
Default
8080
Value
8080
WEBUI_SECRET_KEYVariable

You MUST set WEBUI_SECRET_KEY to a secure, persistent value. Example command: openssl rand -base64 48

ENABLE_OLLAMA_APIVariable

Enables the use of Ollama APIs.

Default
true|false
OLLAMA_BASE_URLVariable

Configures the Ollama backend URL.

Default
http://localhost:11434
Value
http://localhost:11434
ENABLE_OPENAI_APIVariable

Enables the use of OpenAI APIs.

Default
true|false
OPENAI_API_BASE_URLVariable

Configures the OpenAI base API URL.

Default
https://api.openai.com/v1
Value
https://api.openai.com/v1
OPENAI_API_KEYVariable

Sets the OpenAI API key, e.g. sk-124781258123.

WEBUI_AUTHVariable

This setting enables or disables authentication.

Default
true|false
CORS_ALLOW_ORIGINVariable

Sets the allowed origins for Cross-Origin Resource Sharing (CORS). Smicolon ';' separated list of allowed origins.

Default
*
Value
*
ENABLE_CHANNELSVariable

Enables or disables channel support.

Default
false|true
ENABLE_FOLDERSVariable

Enables or disables the folders feature, allowing users to organize their chats into folders in the sidebar.

Default
true|false
ENABLE_NOTESVariable

Enables or disables the notes feature, allowing users to create and manage personal notes within Open WebUI.

Default
true|false
ENABLE_MEMORIESVariable

Enables or disables the memory feature, allowing models to store and retrieve long-term information about users.

Default
true|false
ENABLE_ADMIN_CHAT_ACCESSVariable

Enables admin users to directly access the chats of other users.

Default
true|false
ENABLE_ADMIN_ANALYTICSVariable

Controls whether the Analytics tab is visible and accessible in the admin panel.

Default
true|false
ENABLE_EASTER_EGGSVariable

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
GLOBAL_LOG_LEVELVariable

Sets the global logging level for all Open WebUI components.

Default
INFO|DEBUG|WARNING|ERROR|CRITICAL
ENABLE_EVALUATION_ARENA_MODELSVariable

Enables or disables evaluation arena models.

Default
true|false
ENABLE_MESSAGE_RATINGVariable

Enables message rating feature.

Default
true|false
ENABLE_COMMUNITY_SHARINGVariable

Controls whether users can share content with the Open WebUI Community and access community resources.

Default
true|false
HTTP_PROXYVariable

Proxy for HTTP.

HTTPS_PROXYVariable

Proxy for HTTPS.

NO_PROXYVariable

Comma-separate list of hosts/IPs that bypass the proxy.