doctl compute microdroplet create
Generated on 3 Aug 2026
from doctl version
v1.166.0
Usage
doctl compute microdroplet create <microdroplet-name> [flags]Aliases
cDescription
Creates a new MicroDroplet in the specified region from the specified image. --region, --size, and --image are required. The MicroDroplet UUID and current state are returned on success.
Flags
| Option | Description |
|---|---|
--auto-pause |
Enable auto-pause when the MicroDroplet is idle Default: false |
--auto-pause-idle-timeout |
Idle duration before auto-pause (e.g. 5m, 30s); requires --auto-pause |
--auto-resume |
Enable auto-resume when the MicroDroplet is paused and receives traffic Default: false |
--env |
Environment variables to inject, in KEY=VALUE form. Repeatable. |
--format |
Columns for output in a comma-separated list. Possible values: ID, Name, Region, State, Size, Networking, Image, Endpoint, Created. |
--help, -h |
Help for this command |
--http-port |
HTTP port exposed by the MicroDroplet workload Default: 0 |
--http-protocol |
HTTP protocol served by the MicroDroplet: http or http2 |
--image |
The URN or UUID of a MicroDroplet image to launch (required) |
--networking |
Networking mode for the MicroDroplet: public or vpc |
--no-header |
Return raw data with no headers Default: false |
--region |
A slug specifying the region to create the MicroDroplet in, such as nyc1 (required) |
--size |
A slug indicating the MicroDroplet’s size (required) |
--tag |
Tags to apply to the MicroDroplet. Repeatable. |
--vpc-uuid |
The UUID of a non-default VPC to place the MicroDroplet in (only valid when --networking=vpc) |
Related Commands
| Command | Description |
|---|---|
| doctl compute microdroplet | Manage MicroDroplets |
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 |