Cloudflare R2 Storage

DatoCMS allows you to use your own Cloudflare and Imgix accounts to store your project assets. This allows to be in total control of your data, and to offer a custom CDN domain for your assets — which, by default is www.datocms-assets.com for every project.

How to activate custom Cloudflare R2 storage for your DatoCMS project

To store your DatoCMS assets in a custom Cloudflare R2 bucket please follow these steps:

Create a new bucket

To create a new R2 bucket from the Cloudflare dashboard:

1. Log in to the Cloudflare dashboard and select R2

2. Select Create bucket

3. Enter a name for the bucket

4. At this time, Imgix does not support the "Specify jurisdiction" option, so choose the "Automatic" option for Location, possibly specifying a location hint.

5. Select Create bucket

Configure CORS Policy

Enter the bucket settings, and in the CORS Policy section, select Edit CORS Policy, and paste the following code:

1
[
2
  {
3
    "AllowedOrigins": [
4
      "*"
5
    ],
6
    "AllowedMethods": [
7
      "PUT"
8
    ],
9
    "AllowedHeaders": [
10
      "Content-Type"
11
    ]
12
  }
13
]

Create an R2 API Token

To create a new R2 API Token from the Cloudflare dashboard:

1. Log in to the Cloudflare dashboard and select R2

2. Select Manage R2 API Tokens

3. Click the Create API Token button

4. Specify a name for the token (ie. "DatoCMS Read/Write")

5. Pick the "Object Read & Write" option under Permissions

6. Under Specify bucket(s), select Apply to specific buckets only and select the newly created bucket

7. Under TTL, select "Forever"

8. Click Create API Token

In the next page, make sure to copy the following values (you'll need to pass these info to DatoCMS Support later in the process):

• Access Key ID

• Secret Access Key

• Endpoint for S3 clients

Create an Imgix source

Go to Imgix and create a new account. Create a new source, and link it to the R2 bucket you just created.

Adding a custom domain

If you're not satisfied with the default Imgix subdomain (ie. https://your-source.imgix.net) you can add a custom domain to the Imgix source, then configure your domain DNS settings so that its CNAME record points to your-source.imgix.net:

Enable HTTPS for the Imgix source

DatoCMS requires HTTPS for custom domains. There are two different ways you can enable it. The first one is to request an HTTP certificate to Imgix. From the Imgix documentation:

By default, you will only be able to use the custom subdomain with http. Using https requires an SSL certificate through our CDN partner and incurs additional fees—please contact Imgix Support to set this up.

Alternatively, to get HTTPS for free, you can use Cloudflare on top of Imgix. This is a cheaper alternative, but requires changing your original domain nameservers to the Cloudflare nameservers, which is something you might not want, and might have some impacts in the way assets are returned.

Send request for custom uploads to DatoCMS support

Once everything is ready, send an email to support@datocms.com and request the change. These are the information we'll ask you for:

• Your bucket name (my-bucket-name)

• Your Access Key ID, Secret Access Key and Endpoint for S3 clients

• The Imgix domain (ie. your-source.imgix.net or assets.superduper.com)

Together we'll schedule a maintenance window where we'll transfer every assets already uploaded to your Project to the new R2 bucket, and enable the custom domain.

From then on all new assets you upload will be stored in your AWS R2 bucket, and will be available from your custom Imgix domain.