Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Backup schedules and retention

The choices a host makes when it turns Exponential backups into a service (how often, how many generations, where they are kept, what is backed up before a change) and the retention settings inside Exponential that a…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/hosting/operations/backup-schedules-and-retention.md

On this page

Backup schedules and retention

This page is for product managers who define a backup service for Exponential hosting and for the system administrators who implement it. It answers: which decisions a backup policy has to make, what the Exponential sources recommend, which retention settings exist inside Exponential itself, and how to describe the result to customers without promising what the platform cannot keep.

What goes into a backup is on Backups: what to back up; the commands are on Database backups per engine. This page gives no prices and no fixed figures of its own: every number below is quoted from the repository, and the rest are options for you to decide.

Contents

  1. What the sources recommend
  2. The decisions of a backup policy
  3. Backups before every change
  4. Retention inside Exponential
  5. Backups and erased personal data
  6. Describing the service to customers
  7. Checklist

What the sources recommend

The installation book and the guides state a small number of rules, and they are the floor of any policy:

RuleSource
A backup is the database and the files, taken at the same moment10.9
Store backups away from the server, and keep several generations10.9
Back up before every upgrade: "Back up first, every time"11.1
Test a restore on another machine at least once and after every major upgrade10.9, Restore
Weekly: "A backup from the last seven days exists and has been restored at least once on another machine"Operating a site, weekly checklist

The decisions of a backup policy

Each row is a choice you make for a plan or a customer; the right-hand column says what to consider.

DecisionOptionsWhat to consider
Frequency of the database backupnightly, several times a day, continuoushow much editing the customer does; the online backup of SQLite (.backup) and --single-transaction dumps of InnoDB run without taking the site offline
Frequency of the file backupwith every database backup, or less often with incremental copiesuploads change less often than content, but a restore needs both halves from the same moment
Consistencymaintenance window, or online database plus files right after ita window makes database and files agree; it costs the customer a short 503 page
Generationshow many daily, weekly and monthly copiesthe more generations, the further back a customer can go after a mistake noticed late
Locationanother server, another data center, another provider"away from the server" is the minimum
Encryptionat rest, in transitthe backup contains settings/override/, which holds credentials
Point-in-time recoverynone, or the database's own log-based recoverythe sources name it for PostgreSQL ("point-in-time recovery of its own", Database support); for other engines check their documentation
Who may restorethe host only, or the customer from a panela customer restore must never overwrite another customer's data
Restore testshow often, on which machinea backup "that was never restored is a hope, not a backup"

Tip

Write the policy per plan in one table like this, with your values in a third column, and put it into the plan's description. Support staff then answer "how far back can you go?" from the same table the customer saw.

Backups before every change

Besides the schedule, take a backup right before each risky change. The sources ask for one before:

  • an upgrade of Exponential: the database step "cannot be undone by putting files back" (11.1);
  • a Composer update or package install from the administration: ezupdate asks you to confirm that a backup exists before Install updates (ezupdate);
  • a change of database engine (Moving a site to another database);
  • a restore: back up the current state first, so a wrong restore can be undone.

A host can offer this as a button or a ticket ("snapshot before change"); see Upgrading customer sites.

Retention inside Exponential

Exponential keeps some records for a set time on its own. A backup keeps them longer, so align the two:

RecordSettingShipped value
Audit trail, live files (content, access, system, commerce)audit.ini [AuditChannel_*] LiveDays90 days
Audit trail, archivesArchiveDays730 days
Audit trail, read channelLiveDays / ArchiveDays of AuditChannel_read30 / 90 days
E-mail consent log of people who are gonemailpreferences.ini [ConsentSettings] RetentionDays1095 days
Unconfirmed e-mail opt-ins[ConsentSettings] PendingDays7 days
Suppression list entries[SuppressionSettings] RetentionDays0 (kept forever; only a hash is stored)
Archives of 404.log / security.loglogviewer.ini [RotationSettings]pruned after 30 / 90 days
Archives of other logssite.ini [FileSettings] LogFileRotateCount, LogFileMaxAge3 archives, no age limit

Sources: The audit trail, E-mail preferences, retention, Request logs, Log rotation. The security pages discuss what these values mean for a data protection policy: Log and data retention.

Backups and erased personal data

When a person asks for their data to be erased, Exponential can remove it from the live site (for example ./console exp:mail:preferences erase --email=<address> --yes for the e-mail preferences). The copies in older backups still hold it until those backups expire. How to handle that (shortening retention, documenting the backup period in the privacy notice, restoring with care) is a legal question.

Note

This page describes what the software provides. It is not legal advice. The host and each customer must take their own legal counsel on retention periods and on personal data in backups.

Describing the service to customers

Say what is backed up, how often, how long, where, and how a restore is requested. Avoid promises the platform does not make by itself:

  • "Every backup contains the database and the uploaded files from the same moment" is true when the job is built as on Backups: what to back up.
  • A restore brings back the whole site to that moment; restoring one deleted page is a different service (content can often be recovered from the trash or from older versions inside Exponential instead).
  • Name the restore time you measured in a test, not one you hope for.

Checklist

  • To do: The policy names frequency, generations, location, encryption and who may restore, per plan.
  • To do: Backups leave the server and are encrypted.
  • To do: A backup is taken before every upgrade, Composer update, engine change and restore.
  • To do: Audit, consent and log retention settings are known and agree with the backup period.
  • To do: Restores are tested on a schedule and the measured time is recorded.
  • To do: Erasure requests and backup retention are covered by the host's and customer's legal advice.

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x