DigitalOcean Integration
Connect your DigitalOcean account to Devpilot to provision and manage Droplets for your deployments.
DigitalOcean Integration
The DigitalOcean integration connects your DigitalOcean account to a Devpilot workspace using a personal access token. Once connected, Devpilot can provision Droplets on your behalf, install the Devpilot agent on new servers, and manage their lifecycle.
Prerequisites
- A DigitalOcean account with billing enabled
- An active Devpilot workspace
Required Credentials
Devpilot stores the following fields for a DigitalOcean integration:
| Field | Description |
|---|---|
| Access Key | A descriptive identifier or label for the token (used as the integration's display key). |
| Secret Key | Your DigitalOcean personal access token with read and write scope. |
DigitalOcean uses a single bearer token to authenticate API calls. Devpilot keeps a two-field form for consistency with other providers — the Secret Key field holds your actual token, and Access Key acts as a label.
Creating a Personal Access Token
Generate a Token
Sign in to DigitalOcean. Open API > Personal access tokens > Generate New Token. Name it devpilot-integration, grant Read and Write scope, and set an appropriate expiry (or leave it as no expiry).
Copy the Token
Copy the token value immediately — DigitalOcean displays it only once.
Connect DigitalOcean in Devpilot
Go to Workspace Settings > Integrations and select Connect on the DigitalOcean card. Enter a label in the Access Key field and paste the token into the Secret Key field.
Validate and Save
Devpilot validates the token by making a read-only API call to DigitalOcean before saving. If validation fails, double-check that the token has both read and write scope.
What Devpilot Does on DigitalOcean
When you provision a server, Devpilot:
- Creates a Droplet in the chosen region using the selected size and image
- Adds an SSH key to the Droplet
- Configures a cloud firewall for the required inbound ports
- Tags the Droplet with workspace metadata
- Installs the Devpilot agent on the new Droplet
Testing and Rotating Credentials
Open the DigitalOcean integration and select Test Credentials to re-run validation. To rotate the token, generate a new one in DigitalOcean, update the Secret Key value in Devpilot, then revoke the old token from the DigitalOcean API page.
Troubleshooting
Credential Validation Fails
- Confirm the token is still active in DigitalOcean > API > Personal access tokens.
- Verify the token was created with Read and Write scope — a read-only token cannot provision Droplets.
Droplet Provisioning Fails
- Check your Droplet limit in Account > Limits.
- Make sure the selected region and Droplet size are currently available (DigitalOcean occasionally sells out specific SKUs in a region).
Disconnecting DigitalOcean
Open the DigitalOcean integration and select Remove. Stored credentials are deleted from Devpilot. Droplets already provisioned through Devpilot are not destroyed — manage them from the DigitalOcean control panel if you no longer need them.