CMP

Connect a DigitalOcean account

Manage the droplets in your DigitalOcean account here, next to your other servers: see them all in one list, create new ones, start, stop and reboot them, follow their CPU, memory, disk and traffic, and take and restore snapshots.

1. Create an API token in DigitalOcean

  1. Sign in at cloud.digitalocean.com and open API › Tokens.
  2. Select Generate New Token. Give it a name (e.g. "Cloud portal") and an expiry.
  3. Choose the scopes:
    • Read is enough to list your droplets and their usage.
    • Add Write to also create and delete droplets, start, stop, reboot and power them off, and take, restore and delete snapshots.
  4. Copy the token (it starts with dop_v1_). DigitalOcean shows it only once.

2. Connect it here

  1. Go to Cloud accounts › Connect account and choose DigitalOcean.
  2. Enter an Account name that helps you recognise it, e.g. "DigitalOcean production", and paste the API token.
  3. Select Test and connect. The portal checks the token with DigitalOcean before saving.

Your droplets appear on the Instances page within a minute, and the list refreshes every few minutes. DigitalOcean is always reached directly over the internet, so there is no connector to choose.

What you can do with droplets

Feature Notes
Start, Shut down, Reboot, Power off Shut down asks the operating system to shut down; Power off cuts the power, like pulling the plug. Needs a token with Write access.
Usage CPU over the last five minutes, and this month's public traffic by day, against the droplet's monthly transfer allowance. Memory and disk use need the DigitalOcean metrics agent on the droplet; the instance page shows whether it is installed.
Backups Lists the droplet's snapshots and DigitalOcean's automatic backups. See below.
Details Size, region, creation date, tags, and whether automatic backups and the metrics agent are on.

You can also create droplets in the account from here, and delete the ones you created here. Changing the hostname or root password, rescue mode and the browser console are not available for droplets: use the DigitalOcean control panel for those.

Snapshots and automatic backups

On a droplet's Backups tab:

If it fails

Message What to do
DigitalOcean refused the API token The token was mistyped, has expired or was deleted. Generate a new one and connect again.
The API token may only read Give the token Write access in DigitalOcean (API › Tokens › edit the token's scopes), or generate a new one with Write access.
DigitalOcean is rate-limiting this token Too many requests in a short time, often from other tools using the same token. Try again in a minute.
DigitalOcean could not find it The droplet or snapshot was deleted in DigitalOcean. The list updates at the next refresh.

Security

The token is encrypted when stored and never shown again. Every connection, power action and snapshot change is recorded in the organization's audit log. Disconnecting the account deletes the token here; revoke it in DigitalOcean too if you no longer need it.