podman-quadlet-list - Man Page

List installed quadlets

Synopsis

podman quadlet list [options]

Description

List all Quadlets configured for the current user.

Options

--filter, -f=filter

Filter output based on conditions give.

The filters argument format is of key=value. If there is more than one filter, then pass multiple OPTIONS: --filter foo=bar --filter bif=baz.

Supported filters:

FilterDescription
nameFilter by quadlet name.

--format=format

Pretty-print output to JSON or using a Go template (default "{{range .}}{{.Name}}\t{{.UnitName}}\t{{.Path}}\t{{.Status}}\n{{end -}}")

Print results with a Go template.

PlaceholderDescription
.AppName of application if Quadlet is part of an app
.NameName of the Quadlet file
.PathQuadlet file path on disk
.StatusQuadlet status corresponding to systemd unit
.UnitNameSystemd unit name corresponding to quadlet

Examples

Simple list command

$ podman quadlet list
NAME                            UNIT NAME                     PATH ON DISK                                                          STATUS      APPLICATION
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

Filter list by name.

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

Format list output for a specific field.

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

See Also

podman(1), podman-quadlet(1)

Referenced By

podman-quadlet(1).