> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# DigitalOcean

> Manage Droplets and managed databases on DigitalOcean

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Scopes**: `read`, `write`.
* **Docs**: [https://docs.digitalocean.com/reference/api/oauth/](https://docs.digitalocean.com/reference/api/oauth/)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable                     | Required | Description                                                                                  |
| ---------------------------- | -------- | -------------------------------------------------------------------------------------------- |
| `DIGITALOCEAN_CLIENT_ID`     | Yes      | DigitalOcean OAuth Client ID [Docs](https://docs.digitalocean.com/reference/api/oauth/).     |
| `DIGITALOCEAN_CLIENT_SECRET` | Yes      | DigitalOcean OAuth Client Secret [Docs](https://docs.digitalocean.com/reference/api/oauth/). |

## Setup

1. **Get a DigitalOcean account**: Sign up at [https://www.digitalocean.com](https://www.digitalocean.com) - new accounts get trial credit you can use for testing.
2. **Register an OAuth application**: Go to API > OAuth Applications ([https://cloud.digitalocean.com/account/api/applications](https://cloud.digitalocean.com/account/api/applications)), register an app, and set the callback URL to your app's /api/auth/digitalocean/callback URL.
3. **Set environment variables**: Copy the Client ID and Client Secret into your .env as DIGITALOCEAN\_CLIENT\_ID and DIGITALOCEAN\_CLIENT\_SECRET.
4. **Verify access**: Complete the OAuth flow, then run Get Account and List Droplets.

* Scopes are space-separated 'read write'; request only 'read' if you don't need mutations
* Access tokens expire after 30 days; refresh tokens are single-use and rotate on each refresh
* Creating Droplets provisions billable infrastructure - confirm sizes and regions before running write tools

Provider API reference: [https://docs.digitalocean.com/reference/api/](https://docs.digitalocean.com/reference/api/)

## Tools

| Tool                   | Access | Description                                                   |
| ---------------------- | ------ | ------------------------------------------------------------- |
| List Droplets          | Read   | List Droplets in the account                                  |
| Get Droplet            | Read   | Get a Droplet by ID                                           |
| Create Droplet         | Write  | Create a new Droplet (provisions billable infrastructure)     |
| Delete Droplet         | Write  | Permanently destroy a Droplet by ID                           |
| List Database Clusters | Read   | List managed database clusters in the account                 |
| Get Account            | Read   | Get account information and limits for the authenticated user |

## Example prompts

* List my DigitalOcean Droplets and database clusters with their status and region.
* Create a small Ubuntu Droplet in the region closest to me, after confirming the size and cost with me.