DigitalOcean v4.42.0 published on Thursday, Apr 17, 2025 by Pulumi
DigitalOcean Provider: Installation & Configuration
Installation
The digitalocean provider is available as a package in all Pulumi languages:
- JavaScript/TypeScript: @pulumi/digitalocean
- Python: pulumi-digitalocean
- Go: github.com/pulumi/pulumi-digitalocean/sdk/v4/go/digitalocean
- .NET: Pulumi.Digitalocean
- Java: com.pulumi/digitalocean
The DigitalOcean (DO) provider is used to interact with the resources supported by DigitalOcean. The provider needs to be configured with the proper credentials before it can be used.
Use the navigation to the left to read about the available resources.
Example Usage
# Pulumi.yaml provider configuration file
name: configuration-example
runtime: nodejs
config:
    digitalocean:token:
        value: 'TODO: var.do_token'
import * as pulumi from "@pulumi/pulumi";
import * as digitalocean from "@pulumi/digitalocean";
const config = new pulumi.Config();
const doToken = config.requireObject("doToken");
// Create a web server
const web = new digitalocean.Droplet("web", {});
# Pulumi.yaml provider configuration file
name: configuration-example
runtime: python
config:
    digitalocean:token:
        value: 'TODO: var.do_token'
import pulumi
import pulumi_digitalocean as digitalocean
config = pulumi.Config()
do_token = config.require_object("doToken")
# Create a web server
web = digitalocean.Droplet("web")
# Pulumi.yaml provider configuration file
name: configuration-example
runtime: dotnet
config:
    digitalocean:token:
        value: 'TODO: var.do_token'
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using DigitalOcean = Pulumi.DigitalOcean;
return await Deployment.RunAsync(() =>
{
    var config = new Config();
    var doToken = config.RequireObject<dynamic>("doToken");
    // Create a web server
    var web = new DigitalOcean.Droplet("web");
});
# Pulumi.yaml provider configuration file
name: configuration-example
runtime: go
config:
    digitalocean:token:
        value: 'TODO: var.do_token'
package main
import (
	"github.com/pulumi/pulumi-digitalocean/sdk/v4/go/digitalocean"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		cfg := config.New(ctx, "")
		doToken := cfg.RequireObject("doToken")
		// Create a web server
		_, err := digitalocean.NewDroplet(ctx, "web", nil)
		if err != nil {
			return err
		}
		return nil
	})
}
# Pulumi.yaml provider configuration file
name: configuration-example
runtime: yaml
config:
    digitalocean:token:
        value: 'TODO: var.do_token'
configuration:
  # Set the variable value in *.tfvars file
  # or using -var="do_token=..." CLI option
  doToken:
    type: dynamic
resources:
  # Create a web server
  web:
    type: digitalocean:Droplet
# Pulumi.yaml provider configuration file
name: configuration-example
runtime: java
config:
    digitalocean:token:
        value: 'TODO: var.do_token'
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.digitalocean.Droplet;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var config = ctx.config();
        final var doToken = config.get("doToken");
        // Create a web server
        var web = new Droplet("web");
    }
}
Note for Module Developers Although provider configurations are shared between modules, each module must declare its own provider requirements for additional information.
Configuration Reference
The following configuration inputs are supported:
- token- (Required) This is the DO API token. Alternatively, this can also be specified using environment variables ordered by precedence:- DIGITALOCEAN_TOKEN
- DIGITALOCEAN_ACCESS_TOKEN
 
- spacesAccessId- (Optional) The access key ID used for Spaces API operations (Defaults to the value of the- SPACES_ACCESS_KEY_IDenvironment variable).
- spacesSecretKey- (Optional) The secret access key used for Spaces API operations (Defaults to the value of the- SPACES_SECRET_ACCESS_KEYenvironment variable).
- apiEndpoint- (Optional) This can be used to override the base URL for DigitalOcean API requests (Defaults to the value of the- DIGITALOCEAN_API_URLenvironment variable or- https://api.digitalocean.comif unset).
- spacesEndpoint- (Optional) This can be used to override the endpoint URL used for DigitalOcean Spaces requests. (It defaults to the value of the- SPACES_ENDPOINT_URLenvironment variable or- https://{{.Region}}.digitaloceanspaces.comif unset.) The provider will replace- {{.Region}}(via Go’s templating engine) with the slug of the applicable Spaces region.
- requestsPerSecond- (Optional) This can be used to enable throttling, overriding the limit of API calls per second to avoid rate limit errors, can be disabled by setting the value to- 0.0(Defaults to the value of the- DIGITALOCEAN_REQUESTS_PER_SECONDenvironment variable or- 0.0if unset).
- httpRetryMax- (Optional) This can be used to override the maximum number of retries on a failed API request (client errors, 422, 500, 502…), the exponential backoff can be configured by the- httpRetryWaitMinand- httpRetryWaitMaxarguments (Defaults to the value of the- DIGITALOCEAN_HTTP_RETRY_MAXenvironment variable or- 4if unset).
- httpRetryWaitMin- (Optional) This can be used to configure the minimum waiting time (in seconds) between failed requests for the backoff strategy (Defaults to the value of the- DIGITALOCEAN_HTTP_RETRY_WAIT_MINenvironment variable or- 1.0if unset).
- httpRetryWaitMax- (Optional) This can be used to configure the maximum waiting time (in seconds) between failed requests for the backoff strategy (Defaults to the value of the- DIGITALOCEAN_HTTP_RETRY_WAIT_MAXenvironment variable or- 30.0if unset).