podman/docs/source/markdown/podman-volume-inspect.1.md

% podman-volume-inspect 1

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>