DigitalOcean logo

DigitalOcean Spaces is an object storage service that’s compatible with the Amazon S3 APIs. Spaces includes an integrated CDN that you can enable at no extra cost. It improves performance by delivering your content from the closest servers to your users.

The Spaces CDN works by using a network of edge servers to replicate your content across geographical regions. Users that request content from the CDN endpoint will be served by the edge node that’s closest to them.

Besides improving performance, the CDN reduces bandwidth costs by caching content and providing it via shorter delivery routes. It also offers a layer of extra redundancy in the event of a service failure. DigitalOcean will be able to continue exposing your content if an edge node fails by rerouting traffic to one of the others.

Enabling the CDN

Go ahead and create a new Space on DigitalOcean. You’ll be prompted to choose a datacentre region for your content. Each region is backed by multiple independent edge nodes.


You can enable the CDN at the time you create your Space or at any subsequent point. You’ll need to supply the same values whether you activate the CDN during Space creation or later on.

image of managing CDN settings in DigitalOcean Spaces

To configure the CDN for an existing Space, head to your DigitalOcean control panel, click Spaces in the left sidebar, and navigate to your target Space. Click the Settings tab at the top of the screen, then the “Edit” button next to “CDN (Content Delivery Network)”.

The “Use a custom subdomain” dropdown lets you attach your own subdomain that you’ll be able to use to access the Space’s content. This could look like DigitalOcean can automatically generate an SSL certificate via Let’s Encrypt, securing traffic to your Space. This requires you to already be managing your domain’s DNS records with DigitalOcean. Manual upload of an SSL certificate is offered as an alternative option when you’re using a different provider.

Without a custom subdomain, you’ll need to use DigitalOcean’s special address when you want to load content via the CDN.

Here’s the correct URL if your Space is called my-space and it resides in the NYC1 datacentre:

Omitting the cdn part of the address results in you hitting the standard Spaces endpoint, without CDN support. This can be a common mistake when configuring third-party software – both URLs will work but only the cdn variant gives you the benefits of edge caching.

Setting the Cache TTL

The Edge Cache TTL is the other setting you can change when enabling your CDN. This defines how long individual edge nodes can cache your content for before considering it to be stale.

Getting this value right is important so your users receive content changes in a timely manner but without unduly jeopardizing CDN efficiency and performance. Edge nodes won’t look for changes to items they’ve retrieved from the central Spaces server until the TTL expires.

Long-lived large assets such as images and videos benefit from an extended TTL. DigitalOcean lets you use a maximum of 1 week in its default set of options. Conversely, files like documents or webpage components which are expected to change frequently might need a shorter TTL. This will reduce the delay between a change being uploaded and users getting to see it.

Treating content in your CDN as immutable is often an effective strategy when your system can be engineered to support it. Use a long TTL by default to reduce bandwidth and improve performance. If a resource does need to be changed, upload a new version with a different filename so it’s cached independently of the original. When this approach isn’t viable, it can be best to use multiple Spaces with different TTL policies to separate your long-lived and frequently changing content.

image of setting custom metadata in DigitalOcean Spaces

One final option is to manually override the TTL setting on specific items in your Space. This is achieved by setting the max-age metadata field. You can do this within the Spaces control panel or during upload from an S3-compatible client.

Find the item, click the “More” button to the right of its name, and select “Manage Metadata” from the menu. Click “Add Custom Pairing” and create a new field called x-amz-meta-max-age. Set your desired TTL in seconds as the value.

Evicting Items From The CDN Cache

You can purge your CDN’s cache from the DigitalOcean control panel. Options are available to either clear the cache entirely or evict individual items.

image of managing CDN settings in DigitalOcean Spaces

To initiate a complete purge, navigate to your Space via Spaces > <space name>. Click the Settings tab at the top and scroll to the “CDN (Content Delivery Network)” section. Click the “Purge Cache” button next to the heading name.

image of clearing CDN cache in DigitalOcean Spaces

This will display a dialog that lets you choose the directories to purge from the cache. Select the appropriate level in the hierarchy and then press “Purge Selected Directories.” The cache invalidation request will be sent to the edge servers. It should have an almost immediate effect.

image of managing CDN settings in DigitalOcean Spaces

Individual items can be evicted by browsing the Space’s content and clicking the “More” button next to an object. Select “Purge from CDN Cache” from the menu that appears. You can purge multiple items simultaneously by ticking the checkboxes to the left of the screen, then selecting “Purge from CDN Cache” from the “Actions” menu that’ll appear in the toolbar.

Manual evictions are helpful when you need a quick cache bust to immediately deliver new content to your users. However regular use of this control usually indicates your TTL settings aren’t appropriate for your application. It’s best to develop your system so objects enter the cache with the correct TTL so you can have a hands-off management approach.

Disabling a Space’s CDN

You can disable the CDN for a Space at any time. This will retain all your content but you’ll need to use the regular endpoint to access it. Objects will be immediately removed from the edge network so your existing CDN-based URLs will stop working.

image of managing CDN settings in DigitalOcean Spaces

Find your Space in the DigitalOcean control panel by navigating to Spaces > <space name>. Click the Settings tab at the top of the screen, then the “Edit” button next to the “CDN (Content Delivery Network)” section.

image of disabling the CDN for a DigitalOcean Space


Press the “Disable CDN” button and then the blue “Save” button to confirm your change. You’ll need to type in the name of your Space to confirm your intentions. Click “Disable” to purge your content from the CDN, unlink custom subdomains, and revoke any issued SSL certificates.


The DigitalOcean Spaces CDN enhances performance and reduces bandwidth use by caching your object storage content on local edge nodes close to your users. You can access the CDN over your own subdomain or stick with the default

Configuring and using the CDN is usually straightforward but you should stay conscious of your TTL settings. It’s important to select a caching lifetime that will adequately balance your application’s typical content update frequency with the overall performance of your Space.

Profile Photo for James Walker James Walker
James Walker is a contributor to How-To Geek DevOps. He is the founder of Heron Web, a UK-based digital agency providing bespoke software development services to SMEs. He has experience managing complete end-to-end web development workflows, using technologies including Linux, GitLab, Docker, and Kubernetes.
Read Full Bio »