How to Create Droplets from Custom Images

Validated on 5 Jun 2019 • Last edited on 22 May 2023

Custom images are Linux and Unix-like images you import to DigitalOcean. You can create Droplets based custom images, which lets you migrate and scale your workloads without spending time recreating your environment from scratch.

Create Droplets from Custom Images using Automation

After you upload a custom image to your account, you can create new Droplets from custom images using the Droplet creation doctl command or API endpoint and setting the image field to the image’s ID.

How to create a new Droplet from a backup using the DigitalOcean CLI

To create a new Droplet from a backup via the command-line, follow these steps:

Install doctl, the DigitalOcean command-line tool.
Create a personal access token, and save it for use with doctl.
Use the token to grant doctl access to your DigitalOcean account.
```
              doctl auth init
            
```
Finally, create a new Droplet from a backup with doctl compute droplet create. The basic usage looks like this, but you'll want to read the usage docs for more details:
```
              doctl compute droplet create <droplet-name>... [flags]
            
```

How to create a new Droplet from a backup using the DigitalOcean API

To create a new Droplet from a backup using the DigitalOcean API, follow these steps:

Create a personal access token, and save it for use with the API.

Send a POST request to https://api.digitalocean.com/v2/droplets

cURL

To create a new Droplet from a backup with cURL, call:


                curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  -d '{"name":"example.com","region":"nyc3","size":"s-1vcpu-1gb","image":"ubuntu-20-04-x64","ssh_keys":[289794,"3b:16:e4:bf:8b:00:8b:b8:59:8c:a9:d3:f0:19:fa:45"],"backups":true,"ipv6":true,"monitoring":true,"tags":["env:prod","web"],"user_data":"#cloud-config\nruncmd:\n  - touch /test.txt\n","vpc_uuid":"760e09ef-dc84-11e8-981e-3cfdfeaae000"}' \
  "https://api.digitalocean.com/v2/droplets"

Go

Go developers can use Godo, the official DigitalOcean V2 API client for Go. To create a new Droplet from a backup with Godo, use the following code:


                import (
    "context"
    "os"

    "github.com/digitalocean/godo"
)

func main() {
    token := os.Getenv("DIGITALOCEAN_TOKEN")

    client := godo.NewFromToken(token)
    ctx := context.TODO()

    createRequest := &godo.DropletCreateRequest{
        Name:   "example.com",
        Region: "nyc3",
        Size:   "s-1vcpu-1gb",
        Image: godo.DropletCreateImage{
            Slug: "ubuntu-20-04-x64",
        },
        SSHKeys: []godo.DropletCreateSSHKey{
            godo.DropletCreateSSHKey{ID: 289794},
            godo.DropletCreateSSHKey{Fingerprint: "3b:16:e4:bf:8b:00:8b:b8:59:8c:a9:d3:f0:19:fa:45"}
        },
        Backups: true,
        IPv6: true,
        Monitoring: true,
        Tags: []string{"env:prod","web"},
        UserData: "#cloud-config\nruncmd:\n  - touch /test.txt\n",
        VPCUUID: "760e09ef-dc84-11e8-981e-3cfdfeaae000",
    }

Ruby

Ruby developers can use DropletKit, the official DigitalOcean V2 API client for Ruby. To create a new Droplet from a backup with DropletKit, use the following code:


                require 'droplet_kit'
token = ENV['DIGITALOCEAN_TOKEN']
client = DropletKit::Client.new(access_token: token)

droplet = DropletKit::Droplet.new(
  name: 'example.com',
  region: 'nyc3',
  size: 's-1vcpu-1gb',
  image: 'ubuntu-20-04-x64',
  ssh_keys: [289794,"3b:16:e4:bf:8b:00:8b:b8:59:8c:a9:d3:f0:19:fa:45"],
  backups: true,
  ipv6: true,
  monitoring: true,
  tags: ["env:prod","web"],
  user_data: "#cloud-config\nruncmd:\n  - touch /test.txt\n",
  vpc_uuid: "760e09ef-dc84-11e8-981e-3cfdfeaae000",
)
client.droplets.create(droplet)

Create Droplets from Custom Images using the Control Panel

After you upload a custom image to your account, you can create Droplets from that image in two ways:

During Droplet creation, on the Droplet create screen, in the Choose an image section, select the Custom images tab and choose the custom image you want to use.

Droplet create screen with the Custom Images tab open

From the Images page, on the Custom Images tab, open the More menu of the custom image you want to create a Droplet from. Then, click Start a droplet. This takes you to the Droplet create screen with your custom image pre-selected.

Regardless of which method you choose, finish selecting your options on the Droplet create page, and then click Create Droplet. You can only create Droplets in the same region as your custom image, but you can add custom images to other regions.

After your Droplet is created, you can connect to it with SSH.

Note

If you get a prompt to enter a root password and you don’t have one, verify that the version of cloud-init on your image and is at least 0.7.7. You can also try adding your SSH key to the image before you upload it.