Give Feedback

doctl compute volume-action attach

Generated on 15 Oct 2026 from doctl version v2.0.0

Copy page as Markdown View page as Markdown

Usage

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

Aliases

Description

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 fifteen 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 https://docs.digitalocean.com/products/volumes/how-to/mount/ for details

Example

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

Flags

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`
`--wait-timeout`	The longest doctl waits for the operation to finish, as a `duration` such as 10m or 1h30m. When it elapses, doctl stops waiting and exits with an error, but the operation itself keeps running. Default: `2h0m0s`

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 Default:
`--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`
`--show`	Reveal masked values, such as secrets, instead of hiding them. Values are unmasked automatically in CI Default: `false`
`--trace`	Show a log of network activity while performing a command Default: `false`
`--verbose`, `-v`	Enable verbose output Default: `false`