doctl compute image

Go to Navigation


The sub-commands of doctl compute image manage images. A DigitalOcean image can be used to create a Droplet.

Currently, there are five types of images: snapshots, backups, custom images, distributions, and one-click application.

  • Snapshots provide a full copy of an existing Droplet instance taken on demand.
  • Backups are similar to snapshots but are created automatically at regular intervals when enabled for a Droplet.
  • Custom images are Linux-based virtual machine images that you may upload for use on DigitalOcean. We support the following formats: raw, qcow2, vhdx, vdi, or vmdk.
  • Distributions are the public Linux distributions that are available to be used as a base to create Droplets.
  • Applications, or one-click apps, are distributions pre-configured with additional software, such as WordPress, Django, or Flask.


Option Description
--help , -h Help for this command
Command Description
doctl compute Display commands that manage infrastructure
doctl compute image create Create custom image
doctl compute image delete Permanently delete an image from your account
doctl compute image get Retrieve information about an image
doctl compute image list List images on your account
doctl compute image list-application List available One-Click Apps
doctl compute image list-distribution List available distribution images
doctl compute image list-user List user-created images
doctl compute image update Update an image's metadata

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