.nh
.TH podman\-volume\-create(1)
.SH NAME
.PP
podman\-volume\-create \- Create a new volume

.SH SYNOPSIS
.PP
\fBpodman volume create\fP [\fIoptions\fP]

.SH DESCRIPTION
.PP
Creates an empty volume and prepares it to be used by containers. The volume
can be created with a specific name, if a name is not given a random name is
generated. You can add metadata to the volume by using the \fB\-\-label\fP flag and
driver options can be set using the \fB\-\-opt\fP flag.

.SH OPTIONS
.SS \fB\-\-driver\fP=\fIdriver\fP
.PP
Specify the volume driver name (default \fBlocal\fP). Setting this to a value other than \fBlocal\fP Podman will attempt to create the volume using a volume plugin with the given name. Such plugins must be defined in the \fBvolume\_plugins\fP section of the \fBcontainers.conf\fP(5) configuration file.

.SS \fB\-\-help\fP
.PP
Print usage statement

.SS \fB\-\-label\fP=\fIlabel\fP, \fB\-l\fP
.PP
Set metadata for a volume (e.g., \-\-label mykey=value).

.SS \fB\-\-opt\fP=\fIoption\fP, \fB\-o\fP
.PP
Set driver specific options.
For the default driver, \fBlocal\fP, this allows a volume to be configured to mount a filesystem on the host.
For the \fB\fClocal\fR driver the following options are supported: \fB\fCtype\fR, \fB\fCdevice\fR, and \fB\fCo\fR\&.
The \fB\fCtype\fR option sets the type of the filesystem to be mounted, and is equivalent to the \fB\fC\-t\fR flag to \fBmount(8)\fP\&.
The \fB\fCdevice\fR option sets the device to be mounted, and is equivalent to the \fB\fCdevice\fR argument to \fBmount(8)\fP\&.
The \fB\fCo\fR option sets options for the mount, and is equivalent to the \fB\fC\-o\fR flag to \fBmount(8)\fP with two exceptions.
The \fB\fCo\fR option supports \fB\fCuid\fR and \fB\fCgid\fR options to set the UID and GID of the created volume that are not normally supported by \fBmount(8)\fP\&.
Using volume options with the \fBlocal\fP driver requires root privileges.
When not using the \fBlocal\fP driver, the given options will be passed directly to the volume plugin. In this case, supported options will be dictated by the plugin in question, not Podman.

.SH EXAMPLES
.PP
.RS

.nf
$ podman volume create myvol

$ podman volume create

$ podman volume create \-\-label foo=bar myvol

# podman volume create \-\-opt device=tmpfs \-\-opt type=tmpfs \-\-opt o=nodev,noexec myvol

# podman volume create \-\-opt device=tmpfs \-\-opt type=tmpfs \-\-opt o=uid=1000,gid=1000 testvol

.fi
.RE

.SH SEE ALSO
.PP
\fBpodman\-volume\fP(1), \fBmount\fP(8), \fBcontainers.conf\fP(5)

.SH HISTORY
.PP
January 2020, updated with information on volume plugins by Matthew Heon mheon@redhat.com
\[la]mailto:mheon@redhat.com\[ra]
November 2018, Originally compiled by Urvashi Mohnani umohnani@redhat.com
\[la]mailto:umohnani@redhat.com\[ra]