[GH-ISSUE #193] Podman instructions need updated #36

New issue

Closed

opened 2026-10-18 14:08:21 +00:00 by bsakaguchi · 1 comment

bsakaguchi commented

2026-10-18 14:08:21 +00:00

Owner

Originally created by @youainti on GitHub (Aug 25, 2024).
Original GitHub issue: https://github.com/open-webui/docs/issues/193

The instructions to setup/use podman are out of date. In most cases now, you should be running podman through quadlet/systemd files. I have an example that I got working (using the podlet tool) under podman 4.9.5 on OpenSUSE.

If you are going to install it as a user, then you would put this in ~/.config/containers/systemd/open-webui.container

[Unit]
Description=Open-WebUI container

[Container]
AutoUpdate=registry
ContainerName=open-webui
Environment=OLLAMA_BASE_URL=http://ollama.local:11434 ANONYMIZED_TELEMETRY=False
Image=ghcr.io/open-webui/open-webui:main
Network=slirp4netns:allow_host_loopback=true
PodmanArgs=--add-host ollama.local:10.0.2.2
PublishPort=127.0.0.1:3000:8080
Volume=open-webui:/app/backend/data

[Service]
#restart rules
Restart=on-failure
RestartSec=30s
StartLimitInterval=5min
StartLimitBurst=3

[Install]
#start on boot
WantedBy=default.target

To start things, you would then run:

# this generates
 systemctl --user daemon-reload

# Verify that the quadlet file has been recognized properly
systemctl --user list-unit-files | grep open-webui
systemctl --user list-units | grep open-webui

# start the container/service
systemctl --user start open-webui

Where should I put this in the documents?

Originally created by @youainti on GitHub (Aug 25, 2024). Original GitHub issue: https://github.com/open-webui/docs/issues/193 The instructions to setup/use podman are out of date. In most cases now, you should be running podman through quadlet/systemd files. I have an example that I got working (using the podlet tool) under podman 4.9.5 on OpenSUSE. If you are going to install it as a user, then you would put this in `~/.config/containers/systemd/open-webui.container` ```bash [Unit] Description=Open-WebUI container [Container] AutoUpdate=registry ContainerName=open-webui Environment=OLLAMA_BASE_URL=http://ollama.local:11434 ANONYMIZED_TELEMETRY=False Image=ghcr.io/open-webui/open-webui:main Network=slirp4netns:allow_host_loopback=true PodmanArgs=--add-host ollama.local:10.0.2.2 PublishPort=127.0.0.1:3000:8080 Volume=open-webui:/app/backend/data [Service] #restart rules Restart=on-failure RestartSec=30s StartLimitInterval=5min StartLimitBurst=3 [Install] #start on boot WantedBy=default.target ``` To start things, you would then run: ```bash # this generates systemctl --user daemon-reload # Verify that the quadlet file has been recognized properly systemctl --user list-unit-files | grep open-webui systemctl --user list-units | grep open-webui # start the container/service systemctl --user start open-webui ``` Where should I put this in the documents?

bsakaguchi closed this issue

2026-10-18 14:08:21 +00:00

bsakaguchi commented

2026-10-18 14:08:22 +00:00

Author

Owner

@Classic298 commented on GitHub (Dec 20, 2025):

updated in dev

@Classic298 commented on GitHub (Dec 20, 2025): updated in dev

bsakaguchi referenced this issue

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

[PR #36] [MERGED] Added Langfuse integration tutorial #195