Leave the Storage settings empty to keep using the default SocialSyncs storage. Connecting your own bucket is entirely optional.
Who can set this up: the Storage tab is available to workspace admins. Settings apply to the whole workspace (organization).
What you’ll need
- A Cloudflare account with R2 enabled.
- An R2 bucket to store your files.
- An R2 API token with Object Read & Write permission on that bucket.
- A public URL for the bucket (a Cloudflare custom domain or the bucket’s
r2.devaddress) so uploaded media can be displayed.
Set up Cloudflare R2
Create a bucket
In the Cloudflare dashboard, open R2 and create a new bucket. Choose the Standard storage class and leave the location as Automatic.
Create an R2 API token
Still in R2, open Manage R2 API Tokens and create a token with the Object Read & Write permission. For better security, scope it to the single bucket you just created.When the token is created, copy the Access Key ID and Secret Access Key — the secret is shown only once. Also note your Account ID from the R2 overview page.
Connect it in SocialSyncs
Open Settings → Storage
In SocialSyncs, go to Settings and open the Storage tab (“Custom Cloudflare R2 Storage”).
Fill in your bucket details
Enter the values you collected above:
| Field | What to enter |
|---|---|
| Account ID | Your Cloudflare account ID. |
| Access Key ID | The R2 API token’s access key. |
| Secret Access Key | The R2 API token’s secret key. |
| Bucket Name | The exact name of your R2 bucket. |
| Public Bucket URL | Your custom domain or r2.dev URL (no trailing slash). |
| Region | Optional — leave as auto unless you have a reason to pin a region. |
Test the connection
Use Test connection to verify your credentials. SocialSyncs writes a tiny test object to your bucket to confirm the token can upload. If it fails, re-check the keys, bucket name, and that the token has write permission.
The test leaves a small file named
.postiz-connection-test-… in your bucket. It’s harmless, but you can delete it from the Cloudflare dashboard if you prefer.How it behaves
- New uploads only. Switching storage affects files uploaded after you save. Media you uploaded earlier stays where it is and its links keep working.
- Your secret is protected. The Secret Access Key is encrypted at rest and shown as
••••••••after saving. To change or re-test it later, re-enter the secret. - Reverting is easy. Remove your credentials (or leave the fields empty) to switch back to the default SocialSyncs storage. Again, existing files are unaffected.