Getting Started

DigitalOcean API Setup

Generate a DigitalOcean API token to enable DNS management and droplet deployments

5-10 minutesBeginner Friendly

Current DigitalOcean Support

✅ DNS Management - Fully supported
🔄 Droplet Deployments - Coming soon!

Set up your API credentials now to be ready when droplet deployment support launches.

Prerequisites

Step 1: Access DigitalOcean API Settings

  1. 1
  2. 2

    Navigate to API in the left sidebar

    💡 You can also go directly to: https://cloud.digitalocean.com/account/api/tokens

Step 2: Generate a Personal Access Token

  1. 1

    Click the "Generate New Token" button

  2. 2

    Configure your token:

    Token Name:

    focal-deploy-api

    Expiration:

    Choose No expiration (or 90 days if you prefer to rotate regularly)

    Scopes:

    ✅ Select Read and Write permissions

  3. 3

    Click "Generate Token"

    Important: Copy your token immediately! DigitalOcean will only show it once. If you lose it, you'll need to generate a new one.

  4. 4

    Your token will look like this:

    dop_v1_1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab

    Store this token securely - you'll need it in the next step

Step 3: Add Credentials to Focal Deploy

  1. 1
  2. 2

    Click "Add Cloud Credentials"

  3. 3

    Select "DigitalOcean" as the provider

  4. 4

    Paste your API token from Step 2

  5. 5

    Give your credentials a name (e.g., "Production DigitalOcean")

  6. 6

    Click "Save Credentials"

Success!

Your DigitalOcean credentials are now securely stored and encrypted. You can use them for DNS management and will be ready for droplet deployments when that feature launches.

Security Best Practices

Rotate tokens regularly

Consider setting a 90-day expiration and rotating your tokens quarterly

Use separate tokens for different environments

Create different tokens for production, staging, and development

Never commit tokens to version control

Always use secure credential storage like Focal Deploy's encrypted vault

Monitor token usage

Regularly check the DigitalOcean audit logs for unexpected API activity

Revoke unused tokens

Delete old tokens from DigitalOcean when they're no longer needed

What's Next?

With your DigitalOcean credentials configured, you can:

✅ Manage DNS Records

Use Focal Deploy to manage your DigitalOcean DNS zones and records

🔄 Coming Soon: Deploy to Droplets

Droplet deployment support is in active development. You'll be notified when it's available!

📚 Explore Other Guides

Set up AWS or Google Cloud for immediate deployment options

Troubleshooting

"Invalid API Token" Error

Verify that:

  • You copied the entire token without extra spaces
  • The token hasn't expired (if you set an expiration)
  • You have Read and Write permissions enabled

Token Not Showing After Generation

DigitalOcean only shows tokens once. If you didn't copy it, you'll need to generate a new token. Delete the old one and create a new token following the steps above.

Need to Revoke a Token

Go to the API tokens page, find the token, and click the "Delete" button. Then remove it from Focal Deploy's credentials.

Need Help? Contact our support team at support@focuswithfocal.com

Related Guides