doctl compute volume-action attach

Go to Navigation


doctl compute volume-action attach <volume-id> <droplet-id> [flags]




Attaches a block storage volume to a Droplet.

You can only attach one Droplet to a volume at a time. However, you can attach up to five different volumes to a Droplet at a time.

When you attach a pre-formatted volume to Ubuntu, Debian, Fedora, Fedora Atomic, and CentOS Droplets created on or after April 26, 2018, the volume automatically mounts. On older Droplets, additional configuration is required. Visit for details


The following example attaches a volume with the UUID f81d4fae-7dec-11d0-a765-00a0c91e6bf6 to a Droplet with the ID 386734086:

doctl compute volume-action attach f81d4fae-7dec-11d0-a765-00a0c91e6bf6 386734086


Option Description
--help , -h Help for this command
--wait Instructs the terminal to wait for the volume to attach before returning control to the user
Default: false
Command Description
doctl compute volume-action Display commands to perform actions on a volume

Global Flags

Option Description
--access-token, -t API V2 access token
--api-url, -u Override default API endpoint
--config, -c Specify a custom config file
  • macOS: ${HOME}/Library/Application Support/doctl/config.yaml
  • Linux: ${XDG_CONFIG_HOME}/doctl/config.yaml
  • Windows: %APPDATA%\doctl\config.yaml
--context Specify a custom authentication context name
--http-retry-max Set maximum number of retries for requests that fail with a 429 or 500-level error
Default: 5
--http-retry-wait-max Set the minimum number of seconds to wait before retrying a failed request
Default: 30
--http-retry-wait-min Set the maximum number of seconds to wait before retrying a failed request
Default: 1
--interactive Enable interactive behavior. Defaults to true if the terminal supports it (default false)
Default: false
--output, -o Desired output format [text|json]
Default: text
--trace Show a log of network activity while performing a command
Default: false
--verbose, -v Enable verbose output
Default: false