Podman instructions need updated #38

Closed
opened 2026-02-15 17:05:21 -05:00 by yindo · 1 comment
Owner

Originally created by @youainti on GitHub (Aug 24, 2024).

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 24, 2024). 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?
yindo closed this issue 2026-02-15 17:05:21 -05:00
Author
Owner

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

updated in dev

@Classic298 commented on GitHub (Dec 20, 2025): updated in dev
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: open-webui/docs#38