Cloud storage

GCE Persistent Disk

The GCEPD plug-in can be installed with the following command:

$ docker plugin install rexray/gcepd \

The GCEPD plug-in requires that GCE compute instance has Read/Write Cloud API access to the Compute Engine and Storage services.

NOTE: GCE persistent disks cannot be created if their name contains an underscore. Docker will automatically append prefixes with underscores to your volume names when they are created as part of a compose file, so if you're creating volumes with this plugin using compose (or stack deploy), be sure to set GCEPD_CONVERTUNDERSCORES to true.


The GCEPD plug-in requires the following privileges:

Type Value
network host
mount /dev
allow-all-devices true
capabilities CAP_SYS_ADMIN

The following environment variables can be used to configure the GCEPD plug-in:

Environment Variable Description Default Required
GCEPD_CONVERTUNDERSCORES Set to true if the plugin will reference persistent disks through a docker-compose.yml file false
GCEPD_DEFAULTDISKTYPE The default disk type to consume pd-ssd
GCEPD_STATUSINITIALDELAY Time duration used to wait when polling volume status 100ms
GCEPD_STATUSMAXATTEMPTS Number of times the status of a volume will be queried before giving up 10
GCEPD_STATUSTIMEOUT Maximum length of time that polling for volume status can occur 2m
GCEPD_TAG Only use volumes that are tagged with a label
GCEPD_ZONE GCE Availability Zone
HTTP_PROXY Address of HTTP proxy server to gain access to API endpoint