Custom Images Overview

Plans and Pricing

Custom images are saved to your account as snapshots and follow the same pricing model: they are free to upload and cost $0.05/GB per month to store. When you create Droplets from your custom image, pricing is based on the Droplet price with no additional fees. Like snapshots, there is no additional charge to add an image to additional regions.

Regional Availability

Custom images are available in all regions.

You can create Droplets from custom images in any region where you’ve added the image.

Features

Once you upload a custom image to your DigitalOcean account, you can create Droplets based on that image.

When you upload a custom image, you’ll select a region for it to be available in. You can create Droplets based on a custom image in that region, and you can make your custom image available in additional regions at any time.

Image Requirements

Images you upload to DigitalOcean must meet the following requirements:

  • Operating system. Images must have a Unix-like OS.

  • File format. Images must be in one of the following file formats:

  • Size. Images must be 100 GB or less uncompressed.

  • Filesystem. Images must support the ext3 or ext4 filesystems.

  • cloud-init. Images must have cloud-init 0.7.7 or higher, cloudbase-init, coreos-cloudinit, iginition, or bsd-cloudinit installed and configured correctly. If your image’s default cloud-init configuration lists the NoCloud datasource before the ConfigDrive datasource, Droplets created from your image will not function properly.

    Click here to display detailed cloud-init instructions.

  • SSH configuration. Images must have sshd installed and configured to run on boot. If your image does not have sshd set up, you will not have SSH access to Droplets created from that image unless you recover access using the Droplet console.

You can also upload a custom image that meets the above criteria as a compressed gzip or bzip2 file.

Limits

  • Images must be less than 100 GB uncompressed.

  • Windows images are not supported.

  • ISO images are not currently supported, but we’re considering ISO support in the future. In the interim, if you have an ISO image you want to use, you can create a new image using your VM software of choice and save it again in a supported format. For a detailed walkthrough, see How to Create a DigitalOcean Droplet from an Ubuntu ISO Format Image.

  • You cannot assign a Floating IP to a Droplet created from a custom image.

  • You cannot use IPv6 with Droplets created from custom images.

  • You cannot enable monitoring automatically during Droplet creation when using a custom image. Instead, enable monitoring manually.

  • You must add an SSH key when creating Droplets from a custom image. These Droplets have password authentication disabled by default and it’s not possible to use the control panel to generate or reset the root password.

Known Issues

  • You cannot see the total storage used by custom images.

  • The image upload window does not correctly display the size of the image.