podman-volume-ls(1) General Commands Manual podman-volume-ls(1)
NAME
podman-volume-ls - List all the available volumes
SYNOPSIS
podman volume ls [options]
DESCRIPTION
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.
OPTIONS
--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 exclu-
sive. Filters with different keys always work exclusive.
Volumes can be filtered by the following attributes:
┌─────────────┬────────────────────────────┐
│ Filter │ Description │
├─────────────┼────────────────────────────┤
│ 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 (ac- │
│ │ cepts regex) │
├─────────────┼────────────────────────────┤
│ opt │ Matches a storage driver │
│ │ options │
├─────────────┼────────────────────────────┤
│ scope │ Filters volume by scope │
├─────────────┼────────────────────────────┤
│ after/since │ Filter by volumes created │
│ │ after the given VOLUME │
│ │ (name or tag) │
├─────────────┼────────────────────────────┤
│ until │ Only remove volumes cre- │
│ │ ated before given time- │
│ │ stamp │
└─────────────┴────────────────────────────┘
--format=format
Format volume output using Go template.
Valid placeholders for the Go template are listed below:
┌───────────────────────────┬──────────────────────────────┐
│ Placeholder │ Description │
├───────────────────────────┼──────────────────────────────┤
│ .Anonymous │ Indicates whether volume is │
│ │ anonymous │
├───────────────────────────┼──────────────────────────────┤
│ .CreatedAt ... │ Volume creation time │
├───────────────────────────┼──────────────────────────────┤
│ .Driver │ Volume driver │
├───────────────────────────┼──────────────────────────────┤
│ .GID │ GID of volume │
├───────────────────────────┼──────────────────────────────┤
│ .InspectVolumeData ... │ Don't use │
├───────────────────────────┼──────────────────────────────┤
│ .Labels ... │ Label information associated │
│ │ with the volume │
├───────────────────────────┼──────────────────────────────┤
│ .LockNumber │ Number of the volume's Lib- │
│ │ pod lock │
├───────────────────────────┼──────────────────────────────┤
│ .MountCount │ Number of times the volume │
│ │ is mounted │
├───────────────────────────┼──────────────────────────────┤
│ .Mountpoint │ Source of volume mount point │
├───────────────────────────┼──────────────────────────────┤
│ .Name │ Volume name │
├───────────────────────────┼──────────────────────────────┤
│ .NeedsChown │ Indicates whether volume │
│ │ needs to be chowned │
├───────────────────────────┼──────────────────────────────┤
│ .NeedsCopyUp │ Indicates if volume needs to │
│ │ be copied up to │
├───────────────────────────┼──────────────────────────────┤
│ .Options ... │ Volume options │
├───────────────────────────┼──────────────────────────────┤
│ .Scope │ Volume scope │
├───────────────────────────┼──────────────────────────────┤
│ .Status ... │ Status of the volume │
├───────────────────────────┼──────────────────────────────┤
│ .StorageID │ StorageID of the volume │
├───────────────────────────┼──────────────────────────────┤
│ .Timeout │ Timeout of the volume │
├───────────────────────────┼──────────────────────────────┤
│ .UID │ UID of volume │
├───────────────────────────┼──────────────────────────────┤
│ .VolumeConfigResponse ... │ Don't use │
└───────────────────────────┴──────────────────────────────┘
--help
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.
EXAMPLES
List all volumes.
$ podman volume ls
List all volumes and display content as json format.
$ podman volume ls --format json
List all volumes and display their Driver and Scope fields
$ podman volume ls --format "{{.Driver}} {{.Scope}}"
List volumes with the name foo and label blue.
$ podman volume ls --filter name=foo,label=blue
List volumes with the label key=value.
$ podman volume ls --filter label=key=value
SEE ALSO
podman(1), podman-volume(1)
HISTORY
November 2018, Originally compiled by Urvashi Mohnani umohnani@red-
hat.com ⟨mailto:umohnani@redhat.com⟩
podman-volume-ls(1)
Generated by dwww version 1.16 on Tue Dec 16 06:04:42 CET 2025.