podman-volume-ls - Man Page

List all the available volumes


podman volume ls [options]


Lists all the volumes that exist. The output can be filtered using the --filter flag and can be formatted to either JSON or a Go template using the --format flag. Use the --quiet flag to print only the volume names.


--filter, -f=filter

Filter what volumes are shown in the output. Multiple filters can be given with multiple uses of the --filter flag. Filters with the same key work inclusive, with the only exception being label which is exclusive. Filters with different keys always work exclusive.

Volumes can be filtered by the following attributes:

dangling[Dangling] Matches all volumes not referenced by any containers
driver[Driver] Matches volumes based on their driver
label[Key] or [Key=Value] Label assigned to a volume
name[Name] Volume name (accepts regex)
optMatches a storage driver options
scopeFilters volume by scope
after/sinceFilter by volumes created after the given VOLUME (name or tag)
untilOnly remove volumes created before given timestamp


Format volume output using Go template.

Valid placeholders for the Go template are listed below:

.AnonymousIndicates whether volume is anonymous
.CreatedAtVolume creation time
.DriverVolume driver
.GIDGID of volume
.InspectVolumeData ...Don't use
.LabelsLabel information associated with the volume
.LockNumberNumber of the volume's Libpod lock
.MountCountNumber of times the volume is mounted
.MountpointSource of volume mount point
.NameVolume name
.NeedsChownIndicates whether volume needs to be chowned
.NeedsCopyUpIndicates if volume needs to be copied up to
.OptionsVolume options
.ScopeVolume scope
.StatusStatus of the volume
.StorageIDStorageID of the volume
.TimeoutTimeout of the volume
.UIDUID of volume
.VolumeConfigResponse ...Don't use


Print usage statement.

--noheading, -n

Omit the table headings from the listing.

--quiet, -q

Print volume output in quiet mode. Only print the volume names.


$ podman volume ls

$ podman volume ls --format json

$ podman volume ls --format "{{.Driver}} {{.Scope}}"

$ podman volume ls --filter name=foo,label=blue

$ podman volume ls --filter label=key=value

See Also

podman(1), podman-volume(1)


November 2018, Originally compiled by Urvashi Mohnani umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩

Referenced By