Setting up Cloudflare R2
Cloudflare R2 is the friendliest storage option for many first-time VOD Manager setups. This guide walks you through creating a Cloudflare account, making a bucket, and generating an R2 API token. The first 10 GB are free, so most small test archives cost nothing while you get comfortable.
What you'll do
- Create a free Cloudflare account and open the R2 dashboard.
- Create one private bucket for your VOD archive. A bucket is the folder-like storage space where your videos will live.
- Create access keys VOD Manager can use to save files into that bucket.
- Estimated time: about 10 minutes.
Step 1 — Create a Cloudflare account
R2 sits inside the normal Cloudflare dashboard, so the first step is just account setup. You do not need to move your website to Cloudflare or change any Twitch settings.
- Go to Cloudflare sign up.
- Use an email address you can access, because Cloudflare will ask you to verify it.
- After verification, sign in to the Cloudflare dashboard.
- Look for R2 in the same dashboard sidebar. That is where buckets, API tokens, and the S3 endpoint live.
Step 2 — Enable R2 and create a bucket
A bucket is the storage container VOD Manager writes into. Give it a boring, recognizable name now so you can spot it later on invoices, token screens, and connection forms.
- From the Cloudflare dashboard sidebar, open R2, then Overview.
- Click Purchase R2. The free tier is provisioned automatically; payment information is mainly there to gate paid usage if you grow past the free limits.
- Click Create bucket.
- Name the bucket something clear, such as vod-manager-archives.
- Leave the location hint set to Automatic, then click Create.
Step 3 — Generate an R2 API token
An API token is a private key pair that lets VOD Manager write files to your bucket without using your Cloudflare password. Scope the token to this one bucket so it only has the access it needs.
- In the R2 sidebar, open Manage R2 API Tokens.
- Click Create API token.
- Set permission to Object Read & Write.
- Set bucket scope to the bucket you just made, not every bucket in the account.
- Leave TTL blank for a long-lived token.
- Click Create.
Step 4 — Find your account-specific S3 endpoint
R2 uses an S3-compatible endpoint, which is the account-specific address VOD Manager connects to. In the R2 dashboard, Cloudflare shows it in the S3 API area as https://<account-id>.r2.cloudflarestorage.com. Copy that account host only. Do not add the bucket name to the endpoint field.
Step 5 — Connect VOD Manager
Now move the Cloudflare details into VOD Manager. The important part is the region: for R2, the region is always auto. Do not use us-east-1 or another AWS-style region.
- Open VOD Manager, then Storage, then Add storage profile.
- Choose Cloudflare R2 as the provider.
- Use any friendly name you will recognize later.
- Paste the endpoint from step 4.
- Set Region to auto.
- Enter the bucket name, Access Key ID, and Secret Access Key.
- Click Test connection and watch for the green check.
Common issues
Test connection failed: 403
The access keys are usually wrong or no longer saved correctly. Regenerate the token, copy both keys, and update the storage profile.
No such bucket
Check the bucket name for typos, then check the region. R2 uses auto for the region every time.
Endpoint missing
Use Cloudflare's S3 API copy button in the R2 dashboard. Do not paste a public bucket URL or a URL with the bucket name attached.
Costs to know
Cloudflare lists R2 storage around $0.015 per GB each month after the first 10 GB free. R2 does not charge download fees, which helps when you pull VODs down later for editing or uploads. Writes, lists, and reads are counted as Class A and Class B operations, but their free tiers are generous enough that many small streamer archives stay free or close to free.
Related guides
Save your VODs on R2 automatically
Once R2 is connected, VOD Manager can save future streams to your bucket after Twitch finishes processing them.