From 15bbe0b6ca1de4566c3bfa3616cd677b995d90a5 Mon Sep 17 00:00:00 2001 From: Tobias Heinze Date: Tue, 9 Sep 2025 06:28:29 +0000 Subject: [PATCH 01/10] Added markdown_header Text Splitter option --- docs/getting-started/env-configuration.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/getting-started/env-configuration.md b/docs/getting-started/env-configuration.md index b1486b38..22989dab 100644 --- a/docs/getting-started/env-configuration.md +++ b/docs/getting-started/env-configuration.md @@ -1718,6 +1718,7 @@ Provide a clear and direct response to the user's query, including inline citati - Options: - `character` - `token` + - `markdown_header` - Default: `character` - Description: Sets the text splitter for RAG models. - Persistence: This environment variable is a `PersistentConfig` variable. From e91664251e53114e7d60a51047f737ac4dde71c1 Mon Sep 17 00:00:00 2001 From: Henry Date: Tue, 9 Sep 2025 16:53:08 +0200 Subject: [PATCH 02/10] Add new tutorial for Open WebUI in https --- docs/tutorials/deployment/index.mdx | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/tutorials/deployment/index.mdx b/docs/tutorials/deployment/index.mdx index a5eb7df8..615856b4 100644 --- a/docs/tutorials/deployment/index.mdx +++ b/docs/tutorials/deployment/index.mdx @@ -145,3 +145,13 @@ We're looking for talented individuals to create videos showcasing Open WebUI's allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen > + + From 1ea9307394ad62a6c4547390135769c7cad5ab26 Mon Sep 17 00:00:00 2001 From: Henry Date: Tue, 9 Sep 2025 16:58:47 +0200 Subject: [PATCH 03/10] Medium article added for tutorials --- docs/pipelines/tutorials.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/pipelines/tutorials.md b/docs/pipelines/tutorials.md index 7144eb71..9b124de9 100644 --- a/docs/pipelines/tutorials.md +++ b/docs/pipelines/tutorials.md @@ -26,4 +26,8 @@ with us, as we'd love to feature it here! [Deploying custom Document RAG pipeline with Open-WebUI](https://github.com/Sebulba46/document-RAG-pipeline) (GitHub guide by Sebulba46) -- Step by step guide to deploy Open-WebUI and pipelines containers and creating your own document RAG with local LLM API. +- Step by step guide to deploy Open-WebUI and pipelines containers and creating your own document RAG with local LLM API. + +[Deploy Your Own Open WebUI Interface with HTTPS Security](https://henrynavarro.org/deploy-your-own-open-webui-interface-with-https-security-53a6ea2609d7?sk=a5876acd56b44ea60f10f9b13aa24aee) (Medium article by @hdnh2006) + +- Learn how to deploy Open WebUI 100% secure through https. From cc8675ddac7de01bee7ef756f07b6ab4d1514fb5 Mon Sep 17 00:00:00 2001 From: Classic298 <27028174+Classic298@users.noreply.github.com> Date: Tue, 9 Sep 2025 20:06:27 +0200 Subject: [PATCH 04/10] fix naming --- docs/tutorials/images.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorials/images.md b/docs/tutorials/images.md index ad8a87c9..ca461ade 100644 --- a/docs/tutorials/images.md +++ b/docs/tutorials/images.md @@ -157,7 +157,7 @@ Open WebUI also supports image generation through the **OpenAI APIs**. This opti ### Azure OpenAI -Image generation with a Azure OpenAI Dall-E or GPT-Image is supported with OpenWeb UI. Configure the Image Generation as follows: +Image generation with a Azure OpenAI Dall-E or GPT-Image is supported with Open WebUI. Configure the Image Generation as follows: 1. In Open WebUI, navigate to the **Admin Panel** > **Settings** > **Images** menu. 2. Set the `Image Generation Engine` field to `Open AI` (Azure OpenAI uses the same syntax as OpenAI). From 8de6be12683cfde92f0a698b167e8d086352f20a Mon Sep 17 00:00:00 2001 From: Classic298 <27028174+Classic298@users.noreply.github.com> Date: Tue, 9 Sep 2025 21:48:32 +0200 Subject: [PATCH 05/10] Update ManualDocker.md --- .../quick-start/tab-docker/ManualDocker.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/getting-started/quick-start/tab-docker/ManualDocker.md b/docs/getting-started/quick-start/tab-docker/ManualDocker.md index 77a52845..10a2e0bd 100644 --- a/docs/getting-started/quick-start/tab-docker/ManualDocker.md +++ b/docs/getting-started/quick-start/tab-docker/ManualDocker.md @@ -10,6 +10,14 @@ Start by pulling the latest Open WebUI Docker image from the GitHub Container Re docker pull ghcr.io/open-webui/open-webui:main ``` +### Slim Image Variant + +For environments with limited storage or bandwidth, Open WebUI offers slim image variants that exclude pre-bundled models. These images are significantly smaller but download required models (whisper, embedding models) on first use. + +```bash +docker pull ghcr.io/open-webui/open-webui:main-slim +``` + ## Step 2: Run the Container Run the container with default settings. This command includes a volume mapping to ensure persistent data storage. @@ -18,6 +26,12 @@ Run the container with default settings. This command includes a volume mapping docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main ``` +To use the slim variant instead: + +```bash +docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main-slim +``` + ### Important Flags - **Volume Mapping (`-v open-webui:/app/backend/data`)**: Ensures persistent storage of your data. This prevents data loss between container restarts. From 82fe68a5098c23237ecf2543a24cd17fce21d2c5 Mon Sep 17 00:00:00 2001 From: Classic298 <27028174+Classic298@users.noreply.github.com> Date: Tue, 9 Sep 2025 21:48:59 +0200 Subject: [PATCH 06/10] Update DockerCompose.md --- .../quick-start/tab-docker/DockerCompose.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/getting-started/quick-start/tab-docker/DockerCompose.md b/docs/getting-started/quick-start/tab-docker/DockerCompose.md index a3765c21..63dc6e06 100644 --- a/docs/getting-started/quick-start/tab-docker/DockerCompose.md +++ b/docs/getting-started/quick-start/tab-docker/DockerCompose.md @@ -24,6 +24,24 @@ volumes: open-webui: ``` +### Using Slim Images + +For environments with limited storage or bandwidth, you can use the slim image variant that excludes pre-bundled models: + +```yaml +services: + openwebui: + image: ghcr.io/open-webui/open-webui:main-slim + ports: + - "3000:8080" + volumes: + - open-webui:/app/backend/data +volumes: + open-webui: +``` + +**Note:** Slim images download required models (whisper, embedding models) on first use, which may result in longer initial startup times but significantly smaller image sizes. + ## Starting the Services To start your services, run the following command: From 24aae4b24c6f2af2f8ad39478b02f98ab9a45de7 Mon Sep 17 00:00:00 2001 From: Classic298 <27028174+Classic298@users.noreply.github.com> Date: Tue, 9 Sep 2025 21:49:45 +0200 Subject: [PATCH 07/10] Update intro.mdx --- docs/intro.mdx | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/intro.mdx b/docs/intro.mdx index 58e905bc..39720b91 100644 --- a/docs/intro.mdx +++ b/docs/intro.mdx @@ -33,7 +33,7 @@ Passionate about open-source AI? [Join our team →](https://careers.openwebui.c ![Open WebUI Demo](/images/demo.gif) :::tip -**Looking for an [Enterprise Plan](https://docs.openwebui.com/enterprise)?** – **[Speak with Our Sales Team Today!](mailto:sales@openwebui.com)** +**Looking for an [Enterprise Plan](https://docs.openwebui.com/enterprise)?** — **[Speak with Our Sales Team Today!](mailto:sales@openwebui.com)** Get **enhanced capabilities**, including **custom theming and branding**, **Service Level Agreement (SLA) support**, **Long-Term Support (LTS) versions**, and **more!** ::: @@ -60,6 +60,14 @@ docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open- docker run -d -p 3000:8080 --gpus all --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:cuda ``` +### Slim Image Variants + +For environments with limited storage or bandwidth, Open WebUI offers slim image variants that exclude pre-bundled models. These images are significantly smaller but download required models on first use: + +```bash +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-slim +``` + ### Open WebUI Bundled with Ollama This installation method uses a single container image that bundles Open WebUI with Ollama, allowing for a streamlined setup via a single command. Choose the appropriate command based on your hardware setup: @@ -94,6 +102,12 @@ If you want to try out the latest bleeding-edge features and are okay with occas docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:dev ``` +For the slim variant of the dev branch: + +```bash +docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:dev-slim +``` + ### Updating Open WebUI To update Open WebUI container easily, follow these steps: From 5e6d5594475aa28dfe805ede06dbfbee327a1fce Mon Sep 17 00:00:00 2001 From: Classic298 <27028174+Classic298@users.noreply.github.com> Date: Tue, 9 Sep 2025 22:47:51 +0200 Subject: [PATCH 08/10] Update docker-install.md --- docs/tutorials/docker-install.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/tutorials/docker-install.md b/docs/tutorials/docker-install.md index ac6f678d..a3b3279b 100644 --- a/docs/tutorials/docker-install.md +++ b/docs/tutorials/docker-install.md @@ -1,8 +1,14 @@ --- sidebar_position: 4 -title: 🐳 Installing Docker +title: 🳠Installing Docker --- +:::info **Looking to install Open WebUI?** + +This page covers Docker installation only. For **Open WebUI installation instructions via Docker**, please visit our [Quick Start Guide](https://docs.openwebui.com/getting-started/quick-start/) which provides comprehensive setup instructions. + +::: + :::warning This tutorial is a community contribution and is not supported by the Open WebUI team. It serves only as a demonstration on how to customize Open WebUI for your specific use case. Want to contribute? Check out the contributing tutorial. ::: @@ -21,7 +27,7 @@ This tutorial is a community contribution and is not supported by the Open WebUI 1. **Open your terminal.** -2. **Set up Docker’s apt repository:** +2. **Set up Docker’s apt repository:** ```bash sudo apt-get update From 0ac4eb5e19d47e52644df2f589326a2ea467335f Mon Sep 17 00:00:00 2001 From: Classic298 <27028174+Classic298@users.noreply.github.com> Date: Tue, 9 Sep 2025 22:48:15 +0200 Subject: [PATCH 09/10] Update docker-install.md --- docs/tutorials/docker-install.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/tutorials/docker-install.md b/docs/tutorials/docker-install.md index a3b3279b..772f9d17 100644 --- a/docs/tutorials/docker-install.md +++ b/docs/tutorials/docker-install.md @@ -1,6 +1,6 @@ --- sidebar_position: 4 -title: 🳠Installing Docker +title: 🐳 Installing Docker --- :::info **Looking to install Open WebUI?** @@ -27,7 +27,7 @@ This tutorial is a community contribution and is not supported by the Open WebUI 1. **Open your terminal.** -2. **Set up Docker’s apt repository:** +2. **Set up Docker's apt repository:** ```bash sudo apt-get update From 6c5db258ca85eab293d281ac3bb7d8c247e1f9ad Mon Sep 17 00:00:00 2001 From: Classic298 <27028174+Classic298@users.noreply.github.com> Date: Wed, 10 Sep 2025 10:51:36 +0200 Subject: [PATCH 10/10] Update images.md --- docs/tutorials/images.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/tutorials/images.md b/docs/tutorials/images.md index ca461ade..61f169bb 100644 --- a/docs/tutorials/images.md +++ b/docs/tutorials/images.md @@ -157,7 +157,7 @@ Open WebUI also supports image generation through the **OpenAI APIs**. This opti ### Azure OpenAI -Image generation with a Azure OpenAI Dall-E or GPT-Image is supported with Open WebUI. Configure the Image Generation as follows: +Image generation with Azure OpenAI Dall-E or GPT-Image is supported with Open WebUI. Configure the Image Generation as follows: 1. In Open WebUI, navigate to the **Admin Panel** > **Settings** > **Images** menu. 2. Set the `Image Generation Engine` field to `Open AI` (Azure OpenAI uses the same syntax as OpenAI). @@ -165,7 +165,6 @@ Image generation with a Azure OpenAI Dall-E or GPT-Image is supported with Open 4. Configure the API version to the value you find in the settings of the Azure AI Fountry. 5. Enter your Azure OpenAI API key. - ## Image Router Open WebUI also supports image generation through the **Image Router APIs**. Image Router is an [open source](https://github.com/DaWe35/image-router) image generation proxy that unifies most popular models into a single API.