-------------------------------------------
* **podman**
* **Jonathan Haack**
* **Haack's Networking**
* **webmaster@haacksnetworking.org**
-------------------------------------------
//Podman//
-------------------------------------------
~~NOTOC~~
==== Introduction ====
Rootless Podman runs as user ''worker'' (uid 1001). Lingering is enabled. Graph root is ''/home/worker/podman-local''. Cgroup manager is ''systemd''. Units come from Quadlet files in ''~/.config/containers/systemd/''. Do not use ''podman generate systemd''.
^ Item ^ Value ^
| User | ''worker'' |
| Linger | yes |
| Graph root | ''/home/worker/podman-local'' |
| Cgroup manager | systemd |
| Quadlets | ''~/.config/containers/systemd/*.container'' |
| Version | 5.8.6 |
==== 1. User and linger ====
adduser --system --group --home /home/worker worker
loginctl enable-linger worker
Verify:
loginctl show-user worker -p Linger
id worker
Expect ''Linger=yes''.
==== 2. Install ====
apt install -y podman podman-compose
Confirm as ''worker'':
podman version
podman info --format '{{.Host.Security.Rootless}} {{.Host.CgroupManager}} {{.Store.GraphRoot}}'
Expect ''true systemd /home/worker/podman-local''.
==== 3. Session bus ====
User units need the session bus. As ''worker'':
export XDG_RUNTIME_DIR=/run/user/$(id -u)
export DBUS_SESSION_BUS_ADDRESS=unix:path=${XDG_RUNTIME_DIR}/bus
Do not use ''sudo -u worker''. That drops the session bus. Use ''su - worker'' or run as ''worker'' directly.
==== 4. Quadlets ====
Units live in ''~/.config/containers/systemd/''. Example structure:
mkdir -p ~/.config/containers/systemd
A ''.container'' file has ''[Container]'', ''[Service]'', and ''[Install]''. ''WantedBy=default.target'' starts it. Do not ''systemctl --user enable'' a Quadlet unit. Do not ''podman generate systemd''.
After creating or editing a ''.container'' file:
systemctl --user daemon-reload
systemctl --user reset-failed container-NAME.service
systemctl --user start container-NAME.service
==== 5. Verify ====
systemctl --user is-active container-*.service
podman ps -a
podman info --format '{{.Host.Security.Rootless}} {{.Store.GraphRoot}}'
ls -la ~/.config/containers/systemd/
Expect rootless true, graph root ''/home/worker/podman-local'', and the Quadlet files present. Also, the directory for podman is on the host and uses virtiofs. This keeps the configs and container data accessible by the host. If you need help on setting up virtiofs mounts and configuring the VM, head to [[https://wiki.haacksnetworking.org/doku.php?id=computing:virtmanagerhell|Virt Manager Hell]].
==== Facts ====
* R
*
--- //[[alerts@haacksnetworking.org|oemb1905]] 2026/10/10 01:39//