# Contents

The DigitalOcean Provider lets Daytona manage Workspace projects on DigitalOcean droplets, offering scalable cloud management.

To use it, a DigitalOcean API token with the right permissions is needed to manage droplets for Workspace creation and management.

Prerequisites

To follow along with this article, you should have:

  • A basic understanding of DigitalOcean and Droplets.

  • A DigitalOcean account with access to create API tokens.

  • Installed Daytona's latest version.

Step 1: Preparations

Create a DigitalOcean API Token

To configure the Daytona DigitalOcean Provider, create a DigitalOcean API token with Full Access permission. This token will allow Daytona to manage your droplets. Follow the steps below to create an API token:

  • Step 1.1: Log in to your DigitalOcean account and navigate to the API section in the dashboard.

  • Step 1.2: Click on Generate New Token under the Personal Access Tokens section.

  • Step 1.3: Give your token a descriptive name (e.g., Daytona-provider) and select the scopes required for managing droplets. Name your token descriptively

  • Step 1.4: Click Generate Token and copy your token to use it later.

Now that you have your API token, you can set up the Daytona DigitalOcean Provider.

Step 2: Main Process

Step 2.1: Start Daytona Server

Start the daytona server by running the command

1daytona server
Start Daytona Server

Step 2.2: Install the DigitalOcean Provider

Run the command below, and you will be prompted to choose a provider. Select digitalocean-provider from the list

1daytona provider install
digitalocean provider install

Step 2.3: Set the DigitalOcean Target

Run the following command to initiate the target setup process:

1daytona target set

Step 2.3.1: Select the DigitalOcean Provider

You will be prompted to choose a provider. Select digitalocean-provider from the list.

digitalocean-provider

Step 2.3.2: Create a New Target

After selecting the DigitalOcean provider, create a new target and enter a unique and descriptive name for your DigitalOcean target (e.g., daytona-digitalocean-target).

New Target

Step 2.3.3: Configure DigitalOcean target options

You will be prompted to enter several configuration options for the DigitalOcean provider. Here’s an overview:

  • Auth Token: Enter the API token you generated earlier. If you left it empty, Daytona will attempt to retrieve it from the DIGITALOCEAN_API_TOKEN environment variable.

  • Disk Size: The size of the disk in GB. The default is 20 GB.

  • Image: Select the base image for your droplet (e.g., ubuntu-24-04-x64). More information on images can be found here. here

  • Region: Select the DigitalOcean region where the droplets will be deployed (e.g., nyc3 for New York). Check available regions here

  • Size: Choose the droplet size (e.g., s-1vcpu-1gb). Find available droplet sizes here

DigitalOcean target options

Congratulations! You have successfully configured Daytona DigitalOcean Provider to create and manage droplet workspace.

To verify whether the daytona DigitalOcean provider has been successfully installed or not, run the below command you will get the provider and target configuration information you have configured.

1daytona provider list
provider list

Common Issues and Troubleshooting

You may encounter some common issues while setting up and configuring the DigitalOcean Provider with Daytona. Below are troubleshooting tips to help resolve them:

  1. Problem: Invalid API Token

    Solution: Double-check that your DigitalOcean API token is correct and has the necessary scopes. You can generate a new token if needed. If necessary, you

  2. Problem: Droplet Creation Failure

    Solution: Ensure the selected region, droplet size, and image are valid for your target. Verify that you have sufficient resources (e.g., account limits) on DigitalOcean.

  3. Problem: Provider Errors

    Solution: If you encounter issues with the DigitalOcean provider, it could be due to bugs or limitations in the latest release. Keep an eye on the DigitalOcean Provider GitHub Repository for updates and fixes.

Conclusion

Following this article, you’ve successfully set up and configured the Daytona DigitalOcean Provider. You can now manage Workspaces on DigitalOcean using Daytona, leveraging its powerful infrastructure for your development and deployment needs.

Tags::
  • digitalocean
  • droplets
  • daytona