NAME

podman-volume-inspect - Get detailed information on one or more volumes

SYNOPSIS

podman volume inspect [options] volume […]

DESCRIPTION

Display detailed information on one or more volumes. The output can be formatted using the --format flag and a Go template. To get detailed information about all the existing volumes, use the --all flag. Volumes can be queried individually by providing their full name or a unique partial name.

OPTIONS

--all, -a

Inspect all volumes.

--format, -f=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 the volume was created with

.Labels

Label information associated with the volume

.LockNumber

Number of the volume’s Libpod lock

.MountCount

Number of times the volume is mounted

.Mountpoint

Source of volume mount point

.Name

Volume name

.NeedsChown

Indicates volume needs to be chowned on first use

.NeedsCopyUp

Indicates volume needs dest data copied up on first use

.Options

Volume options

.Scope

Volume scope

.Status

Status of the volume

.StorageID

StorageID of the volume

.Timeout

Timeout of the volume

.UID

UID the volume was created with

--help

Print usage statement

EXAMPLES

$ podman volume inspect myvol
[
     {
          "Name": "myvol",
          "Driver": "local",
          "Mountpoint": "/home/myusername/.local/share/containers/storage/volumes/myvol/_data",
          "CreatedAt": "2023-03-13T16:26:48.423069028-04:00",
          "Labels": {},
          "Scope": "local",
          "Options": {},
          "MountCount": 0,
          "NeedsCopyUp": true,
          "NeedsChown": true
     }
]

$ podman volume inspect --all [ { “Name”: “myvol”, “Driver”: “local”, “Mountpoint”: “/home/myusername/.local/share/containers/storage/volumes/myvol/_data”, “CreatedAt”: “2023-03-13T16:26:48.423069028-04:00”, “Labels”: {}, “Scope”: “local”, “Options”: {}, “MountCount”: 0, “NeedsCopyUp”: true, “NeedsChown”: true } ]


$ podman volume inspect --format “{{.Driver}} {{.Scope}}” myvol local local


## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-volume(1)](podman-volume.1.md)**, **[podman-inspect(1)](podman-inspect.1.md)**

## HISTORY
November 2018, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>