Give Feedback

doctl compute droplet list

Generated on 9 Apr 2025 from doctl version v1.124.0

Usage

doctl compute droplet list [GLOB] [flags]

ls

Retrieves a list of Droplets on your account, including the following information about each:

The Droplet’s ID
The Droplet’s name
The Droplet’s public IPv4 address
The Droplet’s private IPv4 address
The Droplet’s IPv6 address
The memory size of the Droplet in MB
The number of vCPUs on the Droplet
The size of the Droplet’s disk in GB
The Droplet’s data center region
The image the Droplet was created from
The status of the Droplet. Possible values: new, active, off, or archive
The tags assigned to the Droplet
A list of features enabled for the Droplet, such as backups, ipv6, monitoring, and private_networking
The IDs of block storage volumes attached to the Droplet

The following example retrieves a list of all Droplets in the nyc1 region:

doctl compute droplet list --region nyc1

Option	Description
`--format`	Columns for output in a comma-separated list. Possible values: `ID`, `Name`, `PublicIPv4`, `PrivateIPv4`, `PublicIPv6`, `Memory`, `VCPUs`, `Disk`, `Region`, `Image`, `VPCUUID`, `Status`, `Tags`, `Features`, `Volumes`.
`--gpus`	List GPU Droplets only. By default, only non-GPU Droplets are returned. Default: `false`
`--help`, `-h`	Help for this command
`--no-header`	Return raw data with no headers Default: `false`
`--region`	Retrieves a list of Droplets in a specified region
`--tag-name`	Retrieves a list of Droplets with the specified tag name

Command	Description
doctl compute droplet	Manage virtual machines (Droplets)

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`
`--trace`	Show a log of network activity while performing a command Default: `false`
`--verbose`, `-v`	Enable verbose output Default: `false`