DatoCMS allows you to use your own AWS 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.
To store your DatoCMS assets in a custom AWS S3 bucket please follow these steps:
Login to the AWS console and create a new S3 bucket.
Make sure to configure "Object ownership" settings like this:
and "Block Public Access" settings like this:
Make sure to add the following CORS configuration to the bucket:
Create a IAM key for DatoCMS with the following permissions:
1{2 "Version": "2012-10-17",3 "Statement": [4 {5 "Action": [6 "s3:DeleteObject",7 "s3:ListBucket",8 "s3:GetObject",9 "s3:GetBucketLocation",10 "s3:PutObject",11 "s3:PutObjectAcl"12 ],13 "Effect": "Allow",14 "Resource": [15 "arn:aws:s3:::your-bucket-name",16 "arn:aws:s3:::your-bucket-name/*"17 ]18 },19 {20 "Action": [21 "rekognition:DetectLabels",22 "rekognition:DetectModerationLabels"23 ],24 "Effect": "Allow",25 "Resource": "*"26 }27 ]28}
We recommend you to create a stricter IAM key for Imgix as they won't need to upload objects:
1{2 "Version": "2012-10-17",3 "Statement": [4 {5 "Effect": "Allow",6 "Action": [7 "s3:ListBucket",8 "s3:GetBucketLocation",9 "s3:GetObject"10 ],11 "Resource": [12 "arn:aws:s3:::your-bucket-name",13 "arn:aws:s3:::your-bucket-name/*"14 ]15 }16 ]17}
Go to Imgix and create a new account. Create a new source, and link it to the S3 bucket you just created.
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
:
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.
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 S3 bucket name (my-bucket-name
) and region (ie. eu-west-1
)
Your IAM key ID and secret
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 S3 bucket, and enable the custom domain.
From then on all new assets you upload will be stored in your AWS S3 bucket, and will be available from your custom Imgix domain.