[PR #1419] [MERGED] docs: explain the Docker tab's host-gateway line, update step, GPU tag scope, and set the Ollama URL for Podman #1385

New issue

Closed

opened 2026-10-18 14:19:18 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-18 14:19:18 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/1419
Author: @silentoplayz
Created: 9/18/2026
Status: ✅ Merged
Merged: 9/18/2026
Merged by: @silentoplayz

Base: main ← Head: docs/docker-tab-pages

📝 Commits (1)

f8f620c docs: explain the Docker tab's host-gateway line, update step, GPU tag scope, and set the Ollama URL for Podman

📊 Changes

4 files changed (+11 additions, -4 deletions)

View changed files

📝 docs/getting-started/quick-start/tab-docker/DockerCompose.md (+7 -3)
📝 docs/getting-started/quick-start/tab-docker/Podman.md (+2 -0)
📝 docs/getting-started/quick-start/tab-docker/PodmanKubePlay.md (+1 -1)
📝 docs/getting-started/quick-start/tab-docker/PodmanQuadlet.md (+1 -0)

📄 Description

Summary

I compared the Docker Compose, Podman, Quadlet and Podman Kube Play tabs with the repository's Compose files, helper scripts, Dockerfile and image workflow.

Compose: the extra_hosts line is now explained. With no OLLAMA_BASE_URL set, the image looks for Ollama at host.docker.internal:11434, then :12434. An update step is added. The page also says that the Updating tab's Watchtower command targets a container named open-webui, which this Compose file only produces with container_name: open-webui.
The :cuda note now says what the tag does: it moves Open WebUI's own local models (embedding, reranking, Whisper) to the GPU, not Ollama's, falls back to CPU silently, and the pre-release tag is :dev-cuda. The same note is on the Kube Play tab.
Helper scripts: the launcher's --data flag mounts a host folder for Ollama's models only, and docker-run.sh passes no WEBUI_SECRET_KEY.
Podman and Quadlet: OLLAMA_BASE_URL=http://host.containers.internal:11434 is now set in the run command and the unit file, because the image's default host.docker.internal does not resolve under Podman.

None.

Checklist

I have reviewed the relevant documentation and matched the existing style.
This PR meets Open WebUI's contribution standards: it is accurate, relevant to users, narrowly scoped, maintainable, and not promotional content, advertising, lead generation, SEO placement, or a request to list a product, service, provider, integration, gateway, tool, or company primarily for visibility.
I understand that PRs that do not meet these standards may be closed without review and will not be merged. Repeated, low-quality, off-topic, promotional, or intentionally misleading submissions may result in the contributor being blocked from future participation in Open WebUI repositories.

Notes for reviewers

Sources on dev: docker-compose.yaml, docker-compose.data.yaml, docker-compose-launcher.sh, docker-run.sh, Dockerfile (USE_CUDA, OLLAMA_BASE_URL), .github/workflows/docker.yaml for the tag matrix, and config.py for the Ollama URL rewrite. The :dev wording on the Compose page ("in practice a nightly build") is left as is. The image is rebuilt on every push to dev, which is what that sentence means in practice.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/docs/pull/1419 **Author:** [@silentoplayz](https://github.com/silentoplayz) **Created:** 9/18/2026 **Status:** ✅ Merged **Merged:** 9/18/2026 **Merged by:** [@silentoplayz](https://github.com/silentoplayz) **Base:** `main` ← **Head:** `docs/docker-tab-pages` --- ### 📝 Commits (1) - [`f8f620c`](https://github.com/open-webui/docs/commit/f8f620cd26bfe5988af554c5e25467a7e27dee84) docs: explain the Docker tab's host-gateway line, update step, GPU tag scope, and set the Ollama URL for Podman ### 📊 Changes **4 files changed** (+11 additions, -4 deletions) <details> <summary>View changed files</summary> 📝 `docs/getting-started/quick-start/tab-docker/DockerCompose.md` (+7 -3) 📝 `docs/getting-started/quick-start/tab-docker/Podman.md` (+2 -0) 📝 `docs/getting-started/quick-start/tab-docker/PodmanKubePlay.md` (+1 -1) 📝 `docs/getting-started/quick-start/tab-docker/PodmanQuadlet.md` (+1 -0) </details> ### 📄 Description ## Summary I compared the Docker Compose, Podman, Quadlet and Podman Kube Play tabs with the repository's Compose files, helper scripts, Dockerfile and image workflow. - Compose: the `extra_hosts` line is now explained. With no `OLLAMA_BASE_URL` set, the image looks for Ollama at `host.docker.internal:11434`, then `:12434`. An update step is added. The page also says that the Updating tab's Watchtower command targets a container named `open-webui`, which this Compose file only produces with `container_name: open-webui`. - The `:cuda` note now says what the tag does: it moves Open WebUI's own local models (embedding, reranking, Whisper) to the GPU, not Ollama's, falls back to CPU silently, and the pre-release tag is `:dev-cuda`. The same note is on the Kube Play tab. - Helper scripts: the launcher's `--data` flag mounts a host folder for Ollama's models only, and `docker-run.sh` passes no `WEBUI_SECRET_KEY`. - Podman and Quadlet: `OLLAMA_BASE_URL=http://host.containers.internal:11434` is now set in the run command and the unit file, because the image's default `host.docker.internal` does not resolve under Podman. ## Related issue or discussion None. ## Checklist - [x] I have reviewed the relevant documentation and matched the existing style. - [x] This PR meets Open WebUI's contribution standards: it is accurate, relevant to users, narrowly scoped, maintainable, and not promotional content, advertising, lead generation, SEO placement, or a request to list a product, service, provider, integration, gateway, tool, or company primarily for visibility. - [x] I understand that PRs that do not meet these standards may be closed without review and will not be merged. Repeated, low-quality, off-topic, promotional, or intentionally misleading submissions may result in the contributor being blocked from future participation in Open WebUI repositories. ## Notes for reviewers Sources on `dev`: `docker-compose.yaml`, `docker-compose.data.yaml`, `docker-compose-launcher.sh`, `docker-run.sh`, `Dockerfile` (`USE_CUDA`, `OLLAMA_BASE_URL`), `.github/workflows/docker.yaml` for the tag matrix, and `config.py` for the Ollama URL rewrite. The `:dev` wording on the Compose page ("in practice a nightly build") is left as is. The image is rebuilt on every push to `dev`, which is what that sentence means in practice. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:19:18 +00:00