agent safety

Agent safety answer

doctl controls DigitalOcean resources from local credentials.

Credential access

Reads DigitalOcean tokens, kubeconfig, and environment credentials.

Remote mutation

Can create, delete, and modify droplets, clusters, registries, and apps.

Publish/artifact risk

Can deploy apps and push container registry artifacts.

Recommended control

Gate mutating doctl commands and credential access.

Agent-use guidance

Allow read-only listings; require approval for writes, deletes, deploys, and token changes.

install

Additional install commands

macOS

Homebrewverified · 100%

brew install doctl

local Homebrew formula metadata

MacPortsverified · 94%

sudo port install doctl

MacPorts ports tree · www/doctl/Portfile · source: api.github.com

Linux

Alpine Linux apkverified · 92%

sudo apk add doctl

Alpine Linux edge package indexes · doctl · source: dl-cdn.alpinelinux.org

Fedora dnfverified · 92%

sudo dnf install doctl

Fedora Rawhide package metadata · doctl · source: dl.fedoraproject.org

Nixverified · 92%

nix profile install nixpkgs#doctl

nixpkgs package indexes · pkgs/by-name/do/doctl/package.nix · source: api.github.com

Arch Linux pacmanverified · 92%

sudo pacman -S doctl

Arch Linux sync databases · doctl · source: geo.mirror.pkgbuild.com

Windows

Scoopverified · 92%

scoop install main/doctl

Scoop official bucket manifest trees · bucket/doctl.json · source: api.github.com

Windows Package Managerverified · 92%

winget install --id DigitalOcean.Doctl -e

Windows Package Manager source index · DigitalOcean.Doctl · source: cdn.winget.microsoft.com

overview

Package summary

Command-line tool for DigitalOcean

Project links

Commands and aliases

doctl

history

Project history and usage

doctl is DigitalOcean's official command-line interface for the DigitalOcean API. It is the package-manager-facing form of DigitalOcean cloud automation: a Go binary that exposes account, compute, database, Kubernetes, registry, app, VPC, and billing workflows from a terminal.

Project history

DigitalOcean created the public GitHub repository in May 2015. The README identifies doctl as a CLI for the DigitalOcean API and lists a broad command tree covering both early compute primitives and later platform services such as Kubernetes, Apps, databases, monitoring, registries, and VPCs.

Adoption history

doctl has broad package-manager adoption. The official README documents Homebrew on macOS, Snap on supported Linux systems, Arch Linux, Fedora, Nix, Docker Hub images, GitHub release downloads, and source builds. Homebrew analytics show tens of thousands of annual installs, which is high for a provider-specific cloud CLI.

How it is used

Users authenticate with `doctl auth init`, which stores API tokens and defaults in a YAML config file. The CLI is used both interactively and in scripts, often with JSON output, shell completion, multiple authentication contexts, and resource commands such as droplet listing, domain record creation, registry login, and Kubernetes configuration.

Why package nerds care

doctl matters to package nerds because it is a well-maintained example of the cloud-provider CLI pattern: a single static Go program, packaged across Homebrew, Linux distros, Snap, Windows managers, Docker images, and GitHub releases, with API authentication and shell ergonomics as first-class concerns.

Timeline

2015: Public GitHub repository created.
2010s: README documents install routes across Homebrew, Snap, distro packages, Docker Hub, and GitHub releases.
2026-06: v1.163.0 published with release assets for macOS, Linux, Windows, checksums, and source.

Related projects

doctl is tied to the DigitalOcean API and Control Panel. Its README also documents integration points with kubectl, Docker registry credentials, shell completion, and Docker Hub images.

Sources

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for doctl. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

macOS: ~/Library/Application Support/doctl/config.yaml
Unix: $XDG_CONFIG_HOME/doctl/config.yaml~/.config/doctl/config.yaml

Credential files

Credential-bearing paths to review before unattended agent runs.

macOS: ~/Library/Application Support/doctl/config.yaml
Unix: $XDG_CONFIG_HOME/doctl/config.yaml~/.config/doctl/config.yaml

executables

Installed executables

Command	Kind	Exposure	Note
`doctl`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version1.163.0

manager updated2026-06-25

local dataok

upstreamcurrent

latest detectedv1.163.0

https://github.com/digitalocean/doctl

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:doctl
Version	1.163.0
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/doctl
Homepage	https://docs.digitalocean.com/reference/doctl/
Repository	https://github.com/digitalocean/doctl
Upstream docs	https://docs.digitalocean.com/reference/doctl
License	Apache-2.0
Source archive	https://github.com/digitalocean/doctl/archive/refs/tags/v1.163.0.tar.gz
Last updated	2026-06-25T12:48:13Z
Pulse	updated
Build dependencies	go
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	doctl
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

doctl

nix profile install nixpkgs#doctl

normalized package name match
Matched by: Doctl

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/do/doctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

apk95%

doctl 1.160.1-r0

Official command line interface for the DigitalOcean API

https://github.com/digitalocean/doctl

sudo apk add doctl

License: Apache-2.0
Architecture: x86_64
Source Package: doctl
1 dependencies
1 provides
normalized package name match
Matched by: Doctl

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: doctl from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk95%

doctl-bash-completion 1.160.1-r0

Bash completions for doctl

https://github.com/digitalocean/doctl

sudo apk add doctl-bash-completion

License: Apache-2.0
Architecture: x86_64
Source Package: doctl
normalized package name match
Matched by: Doctl

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: doctl-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk95%

doctl-fish-completion 1.160.1-r0

Fish completions for doctl

https://github.com/digitalocean/doctl

sudo apk add doctl-fish-completion

License: Apache-2.0
Architecture: x86_64
Source Package: doctl
normalized package name match
Matched by: Doctl

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: doctl-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk95%

doctl-zsh-completion 1.160.1-r0

Zsh completions for doctl

https://github.com/digitalocean/doctl

sudo apk add doctl-zsh-completion

License: Apache-2.0
Architecture: x86_64
Source Package: doctl
normalized package name match
Matched by: Doctl

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: doctl-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

dnf95%

doctl 1.160.1-1.fc45

The official command line interface for the DigitalOcean API

https://github.com/digitalocean/doctl

sudo dnf install doctl

License: Apache-2.0 AND BSD-2-Clause AND BSD-3-Clause AND ISC AND MIT AND MPL-2.0
Category: Unspecified
Architecture: x86_64
Source Package: doctl
3 dependencies
2 provides
normalized package name match
Matched by: Doctl

Fedora Rawhide package metadata · dl.fedoraproject.org · Fedora Rawhide package metadata: doctl from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

pacman95%

doctl 1.159.0-1

The official command line interface for the DigitalOcean API

https://github.com/digitalocean/doctl

sudo pacman -S doctl

License: Apache-2.0
Architecture: x86_64
1 dependencies
normalized package name match
Matched by: Doctl

Arch Linux sync databases · geo.mirror.pkgbuild.com · Arch Linux sync databases: doctl from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

MacPorts95%

doctl

sudo port install doctl

normalized package name match
Matched by: Doctl

MacPorts ports tree · api.github.com · MacPorts ports tree: www/doctl/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

Scoop95%

main/doctl

scoop install main/doctl

normalized package name match
Matched by: Doctl

Scoop official bucket manifest trees · api.github.com · Scoop official bucket manifest trees: bucket/doctl.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

winget95%

DigitalOcean.Doctl

winget install --id DigitalOcean.Doctl -e

normalized package name match
Matched by: Doctl

Windows Package Manager source index · cdn.winget.microsoft.com · Windows Package Manager source index: DigitalOcean.Doctl from https://cdn.winget.microsoft.com/cache/source.msix

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/doctl.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated agent safety answer
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

Install doctl with Homebrew, apk, dnf, MacPorts, Nix, pacman, scoop, winget

Agent safety answer

Credential access

Remote mutation

Publish/artifact risk

Recommended control

Agent-use guidance

Additional install commands

macOS

Linux

Windows

Package summary

Project links

Commands and aliases

Project history and usage

Project history

Adoption history

How it is used

Why package nerds care

Timeline

Related projects

Sources

No protected-tool coverage found yet

Install behavior

Recommended review

Configuration and credential file locations

Configuration files

Credential files

Installed executables

Version and freshness

Package metadata

Source database details

Other package-manager records

Internal package links

Topical hubs

Related tools

Same workflow

Agent security guides

Generated from repository data

Combined YAML source

Used sources