Skip to main content
Ringee uses Cloudflare R2 for storing files such as call recordings, contact imports, and other media.

​
Setup

1

Create a Cloudflare account

If you don’t have one already, create an account at cloudflare.com.
2

Create an R2 bucket

  1. Navigate to R2 Object Storage in the Cloudflare dashboard
  2. Click Create bucket
  3. Give it a name (e.g., ringee-storage)
  4. Select a location (or leave as automatic)
3

Generate API credentials

  1. Go to R2 → Manage R2 API Tokens
  2. Click Create API token
  3. Grant Object Read & Write permissions
  4. Copy the Access Key ID and Secret Access Key
4

Set up public access (optional)

If you need public URLs for stored files:
  1. Go to your bucket → Settings → Public Access
  2. Enable public access and note the public bucket URL
5

Configure environment variables

Add the following to your .env file:
CLOUDFLARE_BUCKETNAME="ringee-storage"
CLOUDFLARE_ACCOUNT_ID="your_account_id"
CLOUDFLARE_ACCESS_KEY="your_access_key"
CLOUDFLARE_SECRET_ACCESS_KEY="your_secret_access_key"
CLOUDFLARE_BUCKET_URL="https://your-bucket-url.r2.dev"
CLOUDFLARE_REGION="auto"
STORAGE_PROVIDER="cloudflare"

​
Environment Variables

VariableRequiredDescription
CLOUDFLARE_BUCKETNAMEYesName of your R2 bucket
CLOUDFLARE_ACCOUNT_IDYesYour Cloudflare account ID
CLOUDFLARE_ACCESS_KEYYesR2 API access key ID
CLOUDFLARE_SECRET_ACCESS_KEYYesR2 API secret access key
CLOUDFLARE_BUCKET_URLYesPublic URL for the bucket
CLOUDFLARE_REGIONNoRegion (default: auto)
STORAGE_PROVIDERNoStorage provider (default: cloudflare)
Your Cloudflare Account ID can be found in the Cloudflare dashboard URL or under Account Home → Overview on the right sidebar.