1podman-volume-create(1)()                            podman-volume-create(1)()
2
3
4

NAME

6       podman-volume-create - Create a new volume
7
8

SYNOPSIS

10       podman volume create [options]
11
12

DESCRIPTION

14       Creates  an  empty volume and prepares it to be used by containers. The
15       volume can be created with a specific name, if a name is  not  given  a
16       random  name  is generated. You can add metadata to the volume by using
17       the --label flag and driver options can be set using the --opt flag.
18
19

OPTIONS

21   --driver=driver
22       Specify the volume driver name (default local). Setting this to a value
23       other  than local Podman will attempt to create the volume using a vol‐
24       ume plugin with the given name. Such plugins must  be  defined  in  the
25       volume_plugins section of the containers.conf(5) configuration file.
26
27
28   --help
29       Print usage statement
30
31
32   --label=label, -l
33       Set metadata for a volume (e.g., --label mykey=value).
34
35
36   --opt=option, -o
37       Set  driver  specific  options.   For  the  default driver, local, this
38       allows a volume to be configured to mount a  filesystem  on  the  host.
39       For the local driver the following options are supported: type, device,
40       and o.  The type option sets the type of the filesystem to be  mounted,
41       and  is  equivalent to the -t flag to mount(8).  The device option sets
42       the device to be mounted, and is equivalent to the device  argument  to
43       mount(8).   The  o option sets options for the mount, and is equivalent
44       to the -o flag to mount(8) with two exceptions.  The o option  supports
45       uid  and  gid options to set the UID and GID of the created volume that
46       are not normally supported by mount(8).  Using volume options with  the
47       local  driver  requires  root  privileges.   When  not  using the local
48       driver, the given options will be passed directly to the volume plugin.
49       In this case, supported options will be dictated by the plugin in ques‐
50       tion, not Podman.
51
52

EXAMPLES

54              $ podman volume create myvol
55
56              $ podman volume create
57
58              $ podman volume create --label foo=bar myvol
59
60              # podman volume create --opt device=tmpfs --opt type=tmpfs --opt o=nodev,noexec myvol
61
62              # podman volume create --opt device=tmpfs --opt type=tmpfs --opt o=uid=1000,gid=1000 testvol
63
64
65

SEE ALSO

67       podman-volume(1), mount(8), containers.conf(5)
68
69

HISTORY

71       January 2020, updated with information on  volume  plugins  by  Matthew
72       Heon  mheon@redhat.com  ⟨mailto:mheon@redhat.com⟩ November 2018, Origi‐
73       nally    compiled    by     Urvashi     Mohnani     umohnani@redhat.com
74       ⟨mailto:umohnani@redhat.com⟩
75
76
77
78                                                     podman-volume-create(1)()
Impressum