'\" t
.nh
.TH podman-quadlet-list 1
.SH NAME
podman-quadlet-list \- List installed quadlets (alias ls)

.SH SYNOPSIS
\fBpodman quadlet list\fP [\fIoptions\fP]

.SH DESCRIPTION
List all Quadlets configured for the current user.

.SH OPTIONS
.SS \fB--filter\fP, \fB-f\fP=\fIfilter\fP
Filter output based on conditions give.

.PP
If there is more than one filter, the \fB--filter\fR option should be passed multiple times: \fB--filter\fP \fIname=test\fP \fB--filter\fP \fIstatus=active/running\fP\&.

.PP
Supported filters:

.TS
allbox;
l l 
l l .
\fBFilter\fP	\fBDescription\fP
name	Filter by quadlet name
pod	Filter by the \fBPod=\fR value (displays only for .container units)
status	T{
Filter by quadlet status. Valid values: \fBNot loaded\fR, \fBloaded template\fR, \fBactive/running\fR, \fBinactive/dead\fR, \fBfailed/failed\fR, \fBactivating/start\fR, \fBdeactivating/stop\fR
T}
.TE

.SS \fB--format\fP=\fIformat\fP
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 -}}")

.PP
Print results with a Go template.

.TS
allbox;
l l 
l l .
\fB\fBPlaceholder\fP\fP	\fB\fBDescription\fP\fP
\&.App	T{
Name of application if Quadlet is part of an app
T}
\&.Name	Name of the Quadlet file
\&.Path	Quadlet file path on disk
\&.Pod	Pod quadlet file from \fBPod=\fR in \fB[Container]\fR (empty if not set)
\&.Status	T{
Quadlet status corresponding to systemd unit (\fBNot loaded\fR and \fBloaded template\fR are from podman, other values are from systemd)
T}
\&.UnitName	T{
Systemd unit name corresponding to quadlet
T}
.TE

.SS \fB--noheading\fP, \fB-n\fP
Omit the table headings from the listing.

.SH EXAMPLES
Simple list command

.EX
$ 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
.EE

.PP
Filter list by name.

.EX
$ 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
.EE

.PP
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

.PP
Format list output for a specific field.

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

.SH SEE ALSO
\fBpodman(1)\fP, \fBpodman-quadlet(1)\fP, \fBpodman-systemd.unit(5)\fP