Connect DigitalOcean Account

DigitalOcean is the easiest cloud provider to connect - just one click and you're done.

What You'll Get

After connecting your DigitalOcean account, OEC.sh can:

Prerequisites

Before you begin, ensure you have:

• Active DigitalOcean account (Sign up here (opens in a new tab))
• At least one payment method configured in DigitalOcean
• OEC.sh organization admin or appropriate permissions

Step-by-Step Connection

Step 1: Navigate to Cloud Accounts

1. Log in to app.oec.sh (opens in a new tab)
2. Click Settings in the left sidebar
3. Click the Cloud Accounts tab

Step 2: Start Connection

1. Click the Add Account button (top right)
2. Under One-Click Connect (OAuth), find DigitalOcean
3. Click the DigitalOcean card

Step 3: Authorize in DigitalOcean

A new browser tab will open to DigitalOcean:

1. If not logged in, sign in to your DigitalOcean account
2. Review the permissions OEC.sh is requesting:
   • Read access to your account information
   • Write access to manage Droplets, Spaces, and DNS
3. Click Authorize application

Step 4: Confirm Connection

After authorization:

1. The tab automatically closes (or redirects back to OEC.sh)
2. Your DigitalOcean account appears in the list
3. Status shows Active with a green badge
4. You'll see capability badges: Compute, Storage, DNS

Verify Your Connection

Check Account Status

Your connected account should display:

• Name: "DigitalOcean" (you can rename it)
• Status: Active (green)
• Capabilities: Compute, Storage, DNS badges
• Account: Your DigitalOcean email/team name

Test the Connection

1. Find your account in the list
2. Click the refresh icon (circular arrow)
3. Status should remain "Active"
4. If validation fails, see Troubleshooting

What Permissions Does OEC.sh Request?

When you authorize OEC.sh, we request these DigitalOcean scopes:

We never:

• Access your billing information
• Delete resources you created outside OEC.sh
• Share your credentials with third parties

Using Your DigitalOcean Account

For Server Provisioning

1. Go to Servers > Add Server
2. Choose Provision from Cloud (instead of BYOS)
3. Select your DigitalOcean account
4. Choose region, size, and click Provision

For Backup Storage

1. Go to Settings > Storage
2. Click Add Storage Configuration
3. Click Quick Setup on your DigitalOcean account
4. Choose or create a Spaces bucket

For DNS Management

1. Go to Settings > DNS Providers
2. Click Quick Setup on your DigitalOcean account
3. Select the domain you want to manage
4. OEC.sh will automatically create A records

Managing Your Connection

Rename Account

1. Click the pencil icon on your account
2. Enter a descriptive name (e.g., "DO Production", "DigitalOcean EU")
3. Click Save

Set as Default

1. Click the pencil icon on your account
2. Check Set as default for DigitalOcean
3. Click Save

This account will be pre-selected when using DigitalOcean features.

Refresh Token

If your connection shows issues:

1. Click the refresh icon on your account
2. OEC.sh will refresh the OAuth tokens
3. Status should update to "Active"

Reconnect Account

If refresh doesn't work:

1. Click the Reconnect button
2. Re-authorize in the DigitalOcean popup
3. Connection will be restored

Troubleshooting

"Authorization Denied" Error

Cause: You clicked "Deny" or closed the authorization window.

Solution:

1. Click Add Account again
2. Complete the authorization flow
3. Make sure to click "Authorize application"

Account Shows "Expired"

Cause: OAuth tokens expired and couldn't auto-refresh.

Solution:

1. Click Refresh on the account
2. If that fails, click Reconnect
3. Re-authorize OEC.sh

"Insufficient Permissions" When Provisioning

Cause: Your DigitalOcean team permissions may be limited.

Solution:

1. Check your role in DigitalOcean team settings
2. You need at least "Member" role with write access
3. Contact your team owner if needed

Droplet Creation Fails

Cause: Could be quota limits or payment issues.

Solution:

1. Check DigitalOcean dashboard for account alerts
2. Verify your payment method is current
3. Check if you've hit Droplet limits (new accounts have restrictions)
4. Try a different region if capacity is limited

Can't See Spaces Buckets

Cause: You may not have Spaces enabled.

Solution:

1. Go to DigitalOcean dashboard > Spaces
2. Enable Spaces if prompted
3. Create at least one Space
4. Refresh your OEC.sh connection

DigitalOcean Regions

OEC.sh supports all DigitalOcean regions:

Next Steps

• Provision your first server
• Configure backup storage
• Set up custom domains