{"id":4146,"library":"open-webui","title":"Open WebUI","description":"Open WebUI is an extensible, feature-rich, and user-friendly self-hosted AI platform designed to operate entirely offline. It supports various Large Language Model (LLM) runners, including Ollama and OpenAI-compatible APIs, with built-in inference engine for RAG. It provides a ChatGPT-style interface for interacting with local or cloud-based models. The project is actively developed with continuous updates.","status":"active","version":"0.8.12","language":"en","source_language":"en","source_url":"https://github.com/open-webui/open-webui","tags":["AI","LLM","UI","Chatbot","Self-hosted","Ollama","OpenAI API","RAG","Frontend"],"install":[{"cmd":"pip install open-webui","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"Requires Python 3.11 or newer (up to <3.13.0a1) for compatibility.","package":"Python","optional":false}],"imports":[],"quickstart":{"code":"pip install open-webui\nopen-webui serve","lang":"bash","description":"Install Open WebUI via pip and then start the web server. The UI will typically be accessible at http://localhost:8080 (or http://localhost:3000 if using Docker without --network=host)."},"warnings":[{"fix":"Use a specific version tag (e.g., `ghcr.io/open-webui/open-webui:v0.8.12`) instead of `:main` in Docker commands.","message":"When using Docker, the `:main` tag always points to the latest build and can include breaking changes without warning. For production or stability, it is recommended to pin a specific version tag (e.g., `:v0.8.6`).","severity":"breaking","affected_versions":"All versions using `:main` Docker tag"},{"fix":"Set a persistent `WEBUI_SECRET_KEY` environment variable in your deployment environment.","message":"A persistent `WEBUI_SECRET_KEY` environment variable is crucial. Without it, Open WebUI generates a random key on each restart, leading to user logouts and 'Error decrypting tokens' for essential secrets like OAuth tokens or API keys.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Use `python=3.11` when creating virtual environments (e.g., `conda create -n open-webui python=3.11`) or ensure your system default is 3.11.","message":"Ensure you are using Python 3.11 for installation to avoid compatibility issues. The library requires Python <3.13.0a1,>=3.11.","severity":"gotcha","affected_versions":"<0.8.12"},{"fix":"Add `--network=host` and `-e OLLAMA_BASE_URL=http://127.0.0.1:11434` to your `docker run` command.","message":"For Docker deployments with Ollama, connection issues often arise if the WebUI container cannot reach the Ollama server. Using `--network=host` and setting `OLLAMA_BASE_URL` (e.g., `http://127.0.0.1:11434`) in your Docker run command can resolve this.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Ensure `ENABLE_REALTIME_CHAT_SAVE` is set to `False` (or not set, as `False` is the default) in production environments.","message":"Enabling `ENABLE_REALTIME_CHAT_SAVE` in production is strongly discouraged. It causes massive database write pressure and severe performance degradation under concurrent load.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Clear your browser cache (Ctrl+F5 or Cmd+Shift+R) after updating.","message":"After updating Open WebUI, it's a common issue that the UI might appear broken due to stale frontend assets.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Review and restrict user permissions for 'Workspace → Tools' to trusted administrators.","message":"Workspace Tools and Functions execute arbitrary Python code on your server. Restrict Workspace access to trusted administrators only, as granting tool creation/import access is equivalent to giving shell access.","severity":"gotcha","affected_versions":"All versions with Workspace Tools/Functions"}],"env_vars":null,"last_verified":"2026-04-11T00:00:00.000Z","next_check":"2026-07-10T00:00:00.000Z"}