User Tools

Site Tools


computing:podman

This is an old revision of the document!



  • podman
  • Jonathan Haack
  • Haack's Networking
  • webmaster@haacksnetworking.org

Podman


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.

Facts

  • R

— oemb1905 2026/10/09 19:37

— oemb1905 2026/03/30 04:00

computing/podman.1791596362.txt.gz · Last modified: by oemb1905