Image Deprecation Policy

As a general rule, we support the latest point release build of base images until the announced end-of-life date for the distribution and version. Unless there are extenuating circumstances, like critical security vulnerabilities, we strive to provide at least 30 days of notice when we deprecate an image.

You can find image availability and deprecation announcements in our release notes.

Our terms of service govern your use of DigitalOcean and cover details of eligibility, content, use, payments & billing, and warranties. This document is not a contract and all use of DigitalOcean’s services are subject to the terms of service.

Available Images

Base Images

We typically provide images of the current and supported point releases for the distributions available on our platform. Normally, we update default images to their latest LTS releases upon their first point release, and we remove prior point releases when we support the latest point release. For example, we plan to offer Ubuntu 18.04.x until Ubuntu 20.04.1 becomes available.

For most distributions, a point release is a way of differentiating the package set included on installation media. However, some distributions (like RancherOS) use point releases to denote major updates. In these cases, we may continue offering prior versions in the same way that we continue offering trailing major releases for distributions like Ubuntu or CentOS.

One-Clicks

One-Clicks follow the base image policy; they track the latest Ubuntu LTS release until the first point release of the next LTS release. For example, we updated images from 16.04 to 18.04 when 18.04.1 was released and expect to update again when 20.04.1 is released.

Image Slugs

We provide slugs to use when creating resources programmatically. For base images, we provide slugs for the major versions of the distribution which always reference the most current build. For example, debian-9-x64 currently points to Debian 9.5 x64. You can list all available slugs with the API. One-click slugs denote the LTS release of the underlying distribution.

Image Changes and Deprecation

Base Images

When we make a new LTS release of a base image available, we normally keep the prior version available for at least 30 days. We also provide updated base images from time to time to include package updates and patches.

We reserve the right to offer only the latest base builds and may remove older image builds without notice. We may also remove an image without notice if we become aware that an image has an inherent defect or security vulnerability that puts users or data at risk.

Because distributions continually release updates, we can’t guarantee that automated tooling will continue to work when the latest base build updates. If you are providing tools or services which require a specific patch level for a large group of users, you can use custom images or snapshots, but we do recommend choosing LTS and long-term supported images with automation tools.

One-Clicks

Once we rebase a One-Click to the next LTS release, we normally keep the prior version available only via the API for at least 30 days.

Image Slugs

Slugs for base images and One-Clicks that are in the 30-day deprecation period remain available via the API until the image is fully deprecated. All base image slugs that include minor versions (e.g. centos-6-5-x64) are deprecated and will be removed.