doctl compute image create

Go to Navigation

Usage

doctl compute image create <image-name> [flags]

Description

Creates an image in your DigitalOcean account. Specify a URL to download the image from and the region to store the image in. You can add additional metadata to the image using the optional flags.

Example

The following example creates a custom image named Example Image from a URL and stores it in the nyc1 region:

doctl compute image create "Example Image" --image-url "https://example.com/image.iso" --region nyc1

Flags

Option Description
--help , -h Help for this command
--image-description An optional description of the image
--image-distribution A custom image distribution slug to apply to the image
Default: Unknown
--image-url The URL to retrieve the image from (required)
--region The slug of the region you want to store the image in. For a list of region slugs, use the doctl compute region list command. (required)
--tag-names A list of tag names to apply to the image
Command Description
doctl compute image Display commands to manage images

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:
  • 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