# Podman Quadlets (systemd)

Source: https://docs.openwebui.com/getting-started/quick-start/install-methods/podman-quadlets

Podman Quadlets allow you to manage containers as native systemd services. This is the recommended way to run production containers on Linux distributions that use systemd (like Fedora, RHEL, Ubuntu, etc.).

## 🛠️ Setup

1. **Create the configuration directory:** For a rootless user deployment:

```
mkdir -p ~/.config/containers/systemd/
```
2. **Create the container file:** Create a file named `~/.config/containers/systemd/open-webui.container` with the following content:

```
[Unit]
Description=Open WebUI Container
After=network-online.target

[Container]
Image=ghcr.io/open-webui/open-webui:main
ContainerName=open-webui
PublishPort=3000:8080
Volume=open-webui:/app/backend/data
Environment=WEBUI_SECRET_KEY=your-secret-key

# Networking: Pasta is used by default in Podman 5+
# If you need to access host services (like Ollama on the host):
AddHost=host.containers.internal:host-gateway

[Service]
Restart=always

[Install]
WantedBy=default.target
```
3. **Reload systemd and start the service:**

```
systemctl --user daemon-reload
systemctl --user start open-webui
```
4. **Enable auto-start on boot:**

```
systemctl --user enable open-webui
```

## 📊 Management

- **Check status:**

```
systemctl --user status open-webui
```
- **View logs:**

```
journalctl --user -u open-webui -f
```
- **Stop service:**

```
systemctl --user stop open-webui
```

> **Updating**
>
> To update the image, simply pull the new version (`podman pull ghcr.io/open-webui/open-webui:main`) and restart the service (`systemctl --user restart open-webui`).