doctl Command Line Interface (CLI)

doctl is the official DigitalOcean command line interface (CLI).

Features

doctl allows you to interact with the DigitalOcean API via the command line. It supports most functionality found in the control panel. You can create, configure, and destroy DigitalOcean resources like Droplets, Kubernetes clusters, firewalls, load balancers, database clusters, domains, and more.

Official doctl builds are available for Windows, macOS, and Linux.

Documentation

How to Install and Configure doctl

Install and configure doctl, the official DigitalOcean command-line client (CLI).

Command Line Interface (CLI) Reference for doctl

A complete reference for every command provided by the doctl command line interface (CLI).

Resources

doctl is open source software. Find the source code or report issues at the digitalocean/doctl repository on GitHub.

Find additional tutorials on the DigitalOcean community site:

• How To Work with DigitalOcean Load Balancers Using doctl
• How To Secure Web Server Infrastructure With DigitalOcean Cloud Firewalls Using doctl
• How To Work with DigitalOcean Block Storage Using doctl

Limits

• doctl does not support the DigitalOcean Spaces API. However, because the Spaces API is S3-compatible, you can use S3-compatible command line tools like s3cmd to manage Spaces.

Latest Updates

18 August 2023

• Released v1.98.0 of doctl, the official DigitalOcean CLI. This release adds support for automatically retrying API requests that fail with a 429 or 500-level error. The number of attempts can be configured using the --http-retry-max flag or DIGITALOCEAN_HTTP_RETRY_MAX environment variable. To disable retries altogether, set to 0.

10 July 2023

• Released v1.97.0 of doctl, the official DigitalOcean CLI. This release updates the default behavior of the doctl registry login command to set a 30-day expiry for the registry API token that is created when logging in. The previous default behavior was to create a registry API token that did not expire.

  To create a registry API token that does not expire, you can set the new --never-expire flag to true. To set a different expiry time than the default 30 days, you can set the --expiry-seconds flag to an integer representing the number of seconds until the token should expire.

  This also adds support for interacting with uptime checks via doctl. Please see the doctl monitoring uptime command reference for more information.

5 May 2023

• Released v1.94.0 of doctl, the official DigitalOcean CLI. This release updates the doctl auth init prompt and deprecates the --algorithm flag for load balancer sub-commands.

For more information, see the full release notes.