pmx #

A lightweight CLI utility for managing rootless Podman Quadlet container, pod, build, and timer definitions.

Requirements #

• podman
• systemd (user session)

Usage #

pmx <command> [arguments]

Commands #

list, ls, l            List Quadlet and timer units and their systemd status
edit, e <name>         Open or create .container, .pod, .build, or .timer file in $EDITOR
cat, print, p <name>   Print file contents
unit, u <name>         Print generated systemd unit file
grep, g [-i] <pat> [n] Search unit files for a pattern
start <name>           Start the corresponding systemd user service or timer
stop <name>            Stop the corresponding systemd user service or timer
restart <name>         Restart the corresponding systemd user service or timer
enable [--now] <name>  Enable the corresponding systemd user timer
disable [--now] <name> Disable the corresponding systemd user timer
mask [--now] <name>    Mask the corresponding systemd user service or timer
unmask <name>          Unmask the corresponding systemd user service or timer
status, s <name>       Show systemd user status for the unit
logs, log [-f] <name>  Show container or pod logs via podman logs / podman pod logs
check [-v]             Validate Quadlet definitions via dry-run
reload                 Reload systemd user daemon (daemon-reload)

Files are resolved from ${XDG_CONFIG_HOME:-$HOME/.config}/containers/systemd (and ${XDG_CONFIG_HOME:-$HOME/.config}/systemd/user for timers).