doctl compute image create
Generated on 1 Apr 2026
from doctl version
v1.154.0
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.img" --region nyc1Flags
| 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 |
Related Commands
| 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: |
--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 |