podman-quadlet-list(1)      General Commands Manual     podman-quadlet-list(1)

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


SYNOPSIS
       podman quadlet list [options]


DESCRIPTION
       List all Quadlets configured for the current user.


OPTIONS
   --filter, -f=filter
       Filter output based on conditions give.


       If there is more than one filter, the --filter option should be passed
       multiple times: --filter name=test --filter status=active/running.


       Supported filters:


       +-------+---------------------------------------------------------------+
       |Filter | Description                                                   |
       +-------+---------------------------------------------------------------+
       |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
       -}}")


       Print results with a Go template.


       +------------+--------------------------------------------------------------+
       |Placeholder | Description                                                  |
       +------------+--------------------------------------------------------------+
       |.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
       podman(1), podman-quadlet(1), podman-systemd.unit(5)

                                                        podman-quadlet-list(1)