---
name: "docker-quadlet-list"
section: "1"
platform: "linux"
package: "podman-docker"
version: "6.1.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/podman-quadlet-list"
---

# docker-quadlet-list(1)

List installed quadlets (alias ls)

Part of [podman-quadlet-list(1)](/podman-quadlet-list/1.md).

## 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/1.md)**, **[podman-quadlet(1)](/podman-quadlet/1.md)**, **[podman-systemd.unit(5)](/podman-systemd.unit/5.md)**