Site Backups

Frappe Cloud automatically creates backups for sites on the USD 25 plan and above. Automated backups help protect your data and allow you to restore your site if needed. Two types of backups are available: Onsite and Offsite.

Types of Backups

• Onsite Backups – Stored on the same server as your site in compressed format. These backups are generally faster to create and restore.
• Offsite Backups – Backups are compressed using gzip and securely uploaded to an AWS S3 bucket (Mumbai region by default). These backups remain available even if the server hosting your site becomes unavailable.

Automatic Backup Frequency

Frappe Cloud automatically creates a backup of your site every 24 hours.

The Number of Backups setting in ERPNext’s System Settings controls how many onsite backup files are retained within the site. It does not change how frequently Frappe Cloud creates automated backups.

You can also create unlimited on-demand backups whenever required.

Offsite Backups

Offsite backups are stored separately from your application server, providing an additional layer of protection in case of server failures.

During the backup process:

• A backup of the site is created.
• The backup is compressed using gzip.
• The compressed file is uploaded to AWS S3.
• The temporary local backup file is automatically removed after a successful upload.

Offsite Backup Retention Policy

Frappe Cloud automatically retains offsite backups according to the following schedule:

• 7 Daily backups
• 4 Weekly backups
• 12 Monthly backups
• 10 Yearly backups

Additional retention rules:

• Weekly backups are created every Sunday.
• Monthly backups are created on the first day of each month.
• Yearly backups are created on the first day of each year.

Download Backups

1. Open your Site Dashboard.
2. Navigate to the Backups tab.
3. Select the required backup.
4. Download the available backup files.

Each backup includes:

• Database backup
• Public files backup
• Private files backup
• Site configuration backup

Create an On-Demand Backup

1. Open the Backups tab from your Site Dashboard.
2. Click Schedule Backup.
3. The backup request will be queued and processed automatically.

Frequently Asked Questions

Why is my backup file much smaller than the database size?

Backups are compressed using gzip, which significantly reduces their file size. After decompression, the backup size is typically close to the database size shown in your dashboard.

Why do I get “Forbidden: You need System Manager Role to access backup”?

This error occurs when downloading an onsite backup without logging into the site as a user with the System Manager role (or higher). Log in as an administrator and try again.

Can I choose the time when automatic backups run?

By default, backups are created on a round-robin schedule across all sites. If you require backups at a specific time, you can contact Frappe Cloud Support to discuss scheduling options.

Where can I access my backups?

All available backups can be accessed from the Backups tab of your Site Dashboard.

Is there a storage limit for backups?

Offsite backups are stored in AWS S3. Individual backup files can be as large as AWS S3 supports (up to 5 TB).

How are backups secured?

All backup transfers use HTTPS. Backup encryption is optional and can be enabled by configuring a backup encryption key in your site configuration.

Why can’t I find a backup from a specific date?

Backups are retained according to the offsite backup retention policy. Older backups outside the retention window are automatically removed and cannot be recovered.