Dumpling

Guides / PlanetScale

Back up PlanetScale MySQL to Cloudflare R2

Set up automatic, scheduled MySQL backups from PlanetScale into your own Cloudflare R2 bucket — with retention, optional encryption and failure alerts — without writing a script or maintaining a cron server.

Why back up off-platform?

PlanetScale runs its own backups, but exporting is manual. A scheduled `mysqldump` copy in your own bucket keeps you portable.

Zero egress fees and a generous 10 GB free tier make R2 the cheapest home for backups — restoring never costs bandwidth.

Step 1 — Find your PlanetScale database credentials

PlanetScale dashboard → your database → Connect → create a password. Use the host aws.connect.psdb.cloud, port 3306, SSL required.

Then allow the Dumpling worker's static IP address 2.28.121.200 to connect. Keep SSL enabled — PlanetScale requires it. For extra safety, create a read-only user; the exact GRANT statements are in the docs.

Step 2 — Create a Cloudflare R2 bucket and access key

  1. R2 → Create bucket.
  2. R2 → Manage R2 API Tokens → Create API token with Object Read & Write scoped to that bucket.
  3. Copy the Access Key ID, Secret Access Key and the S3 endpoint https://<accountid>.r2.cloudflarestorage.com.

In Dumpling, the endpoint is https://<accountid>.r2.cloudflarestorage.com and the region is auto. R2 charges $0.015/GB-month with no egress fees. Ten GB is free forever, which covers most side projects entirely.

Step 3 — Create the backup job

  1. Sign in (free, no card) and add the database from step 1. Dumpling tests the connection and reports the version and size immediately.
  2. Add the Cloudflare R2 bucket from step 2. Dumpling writes and deletes a tiny test object to confirm the key works.
  3. Create a job: pick a schedule (daily at 02:00 UTC is a good default), how many backups to keep, and optionally a passphrase to encrypt files client-side-decryptably.

The first backup starts right away. From then on, Dumpling runs mysqldump on schedule and streams the output straight into R2. Every run shows the object key, size, duration and log.

Restoring

Download the object from Cloudflare R2 and run:

mysql -e "CREATE DATABASE restored_db"
gunzip < 2026-09-10T02-00-01Z.sql.gz | mysql restored_db

Encrypted files (.enc) decrypt with openssl enc -d -aes-256-cbc -pbkdf2; see the restore docs.

Prefer to do it yourself?

It is a few lines of shell — the hard part is the machine to run it, retention, and knowing when it silently stops working:

# DIY alternative: a cron job on a server you maintain
0 2 * * * mysqldump --single-transaction -h HOST -u USER -p... DB | gzip \
  | aws s3 cp - s3://BUCKET/backups/$(date -u +%FT%TZ).sql.gz --endpoint-url https://<accountid>.r2.cloudflarestorage.com
# ...plus retention, alerting, and a machine to run it on.

Dumpling exists so you do not have to babysit that cron job. The free plan covers one database with daily backups forever.

Back up PlanetScale MySQL to R2 in 3 minutes

No agent. No card. Your bucket.

Start free →

Related guides