podman-quadlet-list(1)

📦
version 6.1.4 · 3 versions
, in arch rolling

🦋 podman-quadlet-list(1) 🦋

okay so this is the General Commands Manual page for podman-quadlet-list, bestie — it's your go-to for listing quadlets, and yes, it has a cute alias. 💅

✨ NAME ✨

podman-quadlet-list — List installed quadlets (alias ls)

🌸 SYNOPSIS 🌸

podman quadlet list [options]

🎀 DESCRIPTION 🎀

List all Quadlets configured for the current user. That's literally it: every quadlet set up for the current user, listed out for you. 🫶

🔥 OPTIONS 🔥

  • --filter, -f=filter — filters the output based on the conditions you give it. If there's more than one filter, pass --filter multiple times: --filter name=test --filter status=active/running.

Supported filters:

  • name — filter by quadlet name
  • pod — filter by the Pod= value (displays only for .container units)
  • status — filter by quadlet status. Valid values: Not loaded, loaded template, active/running, inactive/dead, failed/failed, activating/start, deactivating/stop
  • --format=format — pretty-print output to JSON or using a Go template (default "{{range .}}{{.Name}}\t{{.UnitName}}\t{{.Path}}\t{{.Status}}\t{{.App}}\t{{.Pod}}\n{{end -}}"). Also prints results with a Go template.

Placeholders:

  • .App — name of application if Quadlet is part of an app
  • .Name — name of the Quadlet file
  • .Path — Quadlet file path on disk
  • .Pod — Pod quadlet file from Pod= in [Container] (empty if not set)
  • .Status — Quadlet status corresponding to systemd unit (Not loaded and loaded template are from podman, other values are from systemd)
  • .UnitName — systemd unit name corresponding to quadlet
  • --noheading, -n — omit the table headings from the listing.

🌈 EXAMPLES 🌈

Simple list command:

$ podman quadlet list
NAME                            UNIT NAME                     PATH ON DISK                                                          STATUS      APPLICATION  POD
test-service-quadlet.container  test-service-quadlet.service  /home/user/.config/containers/systemd/test-service-quadlet.container  Not loaded
sample-quadlet.container        sample-quadlet.service        /home/user/.config/containers/systemd/sample-quadlet.container        Not loaded               sample-quadlet.pod
sample-quadlet.pod              sample-quadlet-pod.service    /home/user/.config/containers/systemd/sample-quadlet.pod              Not loaded

Filter list by name:

$ podman quadlet list --filter 'name=test*'
NAME                             UNIT NAME                      PATH ON DISK                                                           STATUS      APPLICATION  POD
test-service-quadlet.container   test-service-quadlet.service   /home/user/.config/containers/systemd/test-service-quadlet.container   Not loaded
test-with-pod.container          test-with-pod.service          /home/user/.config/containers/systemd/test-with-pod.container          Not loaded               mypod.pod

Filter list by pod:

$ podman quadlet list --filter 'pod=mypod'
NAME                          UNIT NAME                    PATH ON DISK                                                         STATUS      APPLICATION  POD
test-with-pod-1.container     test-with-pod-1.service      /home/user/.config/containers/systemd/test-with-pod-1.container     Not loaded               mypod.pod
test-with-pod-2.container     test-with-pod-2.service      /home/user/.config/containers/systemd/test-with-pod-2.container     Not loaded               mypod.pod

Format list output for a specific field:

$ podman quadlet list --format '{{ .UnitName }}'
test-service-quadlet.service
sample-quadlet.service

💜 SEE ALSO 💜

That's the whole page from the General Commands Manual, bestie. The footer didn't give me a source/version/date to hype — just the same podman-quadlet-list(1) title — so this is your cute sign-off. bye! 💖✨💅

📦 where this page comes from