How to use Cloudflare R2

[icidasset]

https://www.cloudflare.com/products/r2/ is a S3 compatible storage that you can use with Diffuse.

1. Create a bucket on Cloudflare R2

2. Create an API token for it if needed

3. Create a new "Amazon S3" source on Diffuse

4. Fill in the details:

   • Use access key and secret from you R2 API token (can be found on the R2 dashboard under 'API Tokens')
   • The bucket name should be the name of the bucket you just created
   • Region must be auto or us-east-1
   • Host must be the S3 API Url from your R2 dashboard without the bucket name at the end
     This should look something like https://67d0565dd63d****************.r2.cloudflarestorage.com
     (Located under: Use R2 with APIs → Select API → S3 Compatible API)

5. Set up CORS on your R2 bucket:

   [
     {
       "AllowedOrigins": [
         "*"
       ],
       "AllowedMethods": [
         "GET",
         "HEAD"
       ],
       "AllowedHeaders": [
         "Range",
         "X-Playback-Session-Id"
       ],
       "ExposeHeaders": [
         "Accept-Ranges",
         "Content-Length",
         "Content-Range"
       ],
       "MaxAgeSeconds": 31536000
     }
   ]

   This can be configured in the Cloudflare dashboard under Settings → CORS Policy.
   You can further customise this to for example only allow the https://diffuse.sh origin.

6. Add the source

7. Wait for processing to finish 🎷