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

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

**podman quadlet list** \[*options*]

# [DESCRIPTION](#DESCRIPTION)

List all Quadlets configured for the current user.

# [OPTIONS](#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 status Filter by quadlet status. Valid values: **Not loaded**, **active/running**, **inactive/dead**, **failed/failed**, **activating/start**, **deactivating/stop** pod Filter by the **Pod=** value (displays only for .container units)

## **--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 .UnitName Systemd unit name corresponding to quadlet

## **--noheading**, **-n**

Omit the table headings from the listing.

# [EXAMPLES](#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](#SEE_ALSO)

[**podman(1)**](/man/os/podman/podman.1), [**podman-quadlet(1)**](/man/os/podman/podman-quadlet.1), [**podman-systemd.unit(5)**](/man/os/podman/podman-systemd.unit.5)

---

Document: podman-quadlet-list(1) from podman 6.0.0-r4 (Chainguard OS)