How to back up to S3, Backblaze B2, Wasabi or Cloudflare R2
Any storage that speaks the S3 protocol can hold your backups: Amazon S3, Backblaze B2, Wasabi, Cloudflare R2, MinIO and others. You need an endpoint address, an access key, a secret key and a bucket.
Before you start
- At your storage provider, create a bucket for the backups.
- Create an access key (key ID and secret key) that may read, write, list and delete objects in that bucket.
- Note the provider's S3 endpoint (for example
https://s3.eu-central-1.wasabisys.com) and the region.
Steps
- In the administrator panel (
https://<server>:2087), open Backup Jobs (section Websites). - Under Destinations, click Add destination.
- Name — for example
Wasabi. - Storage — choose S3-compatible (Amazon S3, Backblaze B2, Wasabi, Cloudflare R2, MinIO…).
- Server / S3 endpoint — the endpoint with
https://, for examplehttps://s3.eu-central-1.wasabisys.com. Enter only the address, without a bucket or path after it. - Access key / username — the access key ID.
- Secret key / password — the secret key.
- Bucket and folder (S3) / folder — the bucket name, then optionally a folder, for example
my-bucket/server1. - Region (S3) — the bucket's region, for example
eu-central-1. Left empty,us-east-1is used. - Click Save. The connection is tested and the result is shown at the top of the page.
Then choose the destination in a backup job.
Good to know
- The endpoint must look like
https://hostorhttps://host:port. A value with a path (https://host/bucket) is refused with "Endpoint must look like https://s3.eu-central-1.wasabisys.com". - The folder may contain letters, digits,
.,-,_and/. - Use one folder per server (
my-bucket/server1,my-bucket/server2) if several servers share a bucket. - Old copies are deleted by the job: when a job keeps 7 copies, the 8th oldest archive of each account is removed from the bucket after a new one arrives. If your bucket has a lifecycle rule or object lock, make sure it allows that.
Common questions
The test says "External storage: …" with an error. What now?
The text after "External storage:" comes from the storage provider. Most often the key is wrong, the key has no permission on the bucket, the bucket name is misspelled or the region does not match. Fix the value, click Save again (leave the secret empty to keep it) or click Test.
Do I need to create the bucket first?
Yes. Create the bucket at your provider; the panel creates the folders inside it.
Can several servers use the same bucket?
Yes, give each server its own folder in Bucket and folder (S3) / folder, so their copies stay apart.
Thank you — this helps us improve the article.
Still stuck?
Ask the AI about your exact situation — it answers from this knowledge base — or contact us.
Related articles
- How to add an external backup destination (off-server backups)
Keep backup copies off the server on S3-compatible storage, an SFTP or FTP server, Google Drive, OneDrive or Dropbox, then send a backup job there.
- How to create a backup job (schedule automatic backups)
Schedule automatic backups of files, databases and email — from every 15 minutes to monthly — with how many copies to keep and where to store them.
- Backup failed: how to read backup and restore errors
Where backup, snapshot and restore errors are shown, what the common messages mean, and how to fix failed backups and failed external copies.