Skip to content

Backups ​

Backups holds the snapshots taken of your hosting account. You browse a snapshot like a file tree, and restore what you need out of it: files, a database, a mailbox, or a single mail folder.

Overview ​

URL: /client/backups

Open it from Files > Backups in the sidebar.

The header states when the Last backup ran, when the Next scheduled backup is due, and the Retention your provider set. Whether you can restore yourself is also your provider's decision: when self-service restore is switched off for your account, the page says restores are handled by your provider, and support can run them for you.

When backups are not set up ​

Since panel 1.9.0, the Backups page is shown whenever your hosting plan includes backups, even when no backups are being made for your account. The page then says why, instead of listing snapshots:

  • Backups are not set up for your account yet - your provider has not assigned a backup policy to your account.
  • Backups are paused for your account - your provider has a backup policy for your account, but it is switched off.
  • Backups are switched off for your account - your provider has excluded your account from backups.
  • Your hosting plan does not include backups - since panel 1.9.6. Your provider has set up your hosting plan without backups. Contact your provider if you need backups for this account.

In each case no backups are being made, and Backup now and the restore actions are not available. Contact your provider to have backups switched on.

The Backups page of an account on a hosting plan without backups

When you run the server yourself ​

Since panel 1.9.4, the notice does not send you to a provider when there is none: on a server set up for its owner's own websites (Host my own websites during the first run), and while an administrator views the account through impersonation, it says what is missing and where to set it up in the admin panel:

  • Not set up yet - add a destination under Backups > Destinations if there is none yet, then a policy under Backups > Policies that covers this account, for example a server-wide one for all accounts. While the backup setup guide under Backups > Overview is still shown, the notice points to it.
  • Paused - switch the policy back on under Backups > Policies.
  • Switched off - open Customers > Accounts in the admin panel, show the Backups column, which is hidden by default, and switch it on for this account. If no policy covers the account yet, add one under Backups > Policies as well.

An administrator who impersonates the account also gets buttons to those pages: Set up backups while the setup guide is shown, otherwise Backups > Destinations and Backups > Policies, or Customers > Accounts, opened on this account. A customer of a hosting provider keeps the wording above. See Backup Policies and Backup Destinations.

For every reader, when the hosting plan also includes Filesystem Backups, the notice adds that it is a separate feature, in the Files menu: on-demand archives of the files of one domain, made when you ask for them. It works without a backup policy and does not replace scheduled backups of the whole account. See Filesystem Backups.

Choosing a restore point ​

Restore point lists the snapshots of your own account, newest first, each with its date and size. Pick one, and the file browser below fills with the contents of your home directory as it was at that moment.

  • Folders are listed first, then files, each group alphabetically.
  • Load more pages through a large folder. Since panel 1.9.3, a folder is listed 200 entries at a time, and Load more adds the next 200 until every file in it is listed. The order applies to the entries listed so far.
  • Search finds a file by name inside the selected snapshot. Type at least three characters. Since panel 1.9.3, a search shows the first 200 matches, and when there are more it says "Only the first 200 matches are shown. Use a more specific search term to find the file you need."

Since panel 1.9.6, each hosting account sees and restores only its own snapshots. An account created under a username that was used before starts with backups of its own.

Restoring files ​

Tick what you need in the browser, then use one of the restore actions:

  • Restore selected - put the selected files and folders back where they came from. Existing files with the same names are overwritten.
  • Restore as copy or Restore copy to home directory - place a copy in the restored-files folder of your home directory instead, so nothing in place is touched.
  • Restore entire home directory - put the whole snapshot back.

A restore runs in the background. Recent restores below the browser lists what has run and how it ended. A restore can only start from a restore point the page listed.

Note: Restores are rate limited. When one is already running, or one finished a moment ago, the page names the wait before the next one can start.

Restoring a database ​

Database dumps in this snapshot lists the database dumps the snapshot holds.

  • Restore copy to home directory - download the dump into your home directory, to inspect or import yourself.
  • Restore into the database - import the dump back into the database it came from. The current contents of that database are saved to ~/backups first, so an import you did not want can be undone.

Restoring mail ​

Two actions restore mail out of the selected snapshot. Both are available once a restore point is picked.

Restore mailbox ​

Restore mailbox brings a mailbox back from the snapshot.

  • Mailbox - the mailboxes the snapshot holds. One that no longer exists on the server is marked (deleted).
  • New password - required when the mailbox was deleted. The mailbox is recreated with this password before its messages are restored.

A mailbox that still exists keeps its password and receives the messages the snapshot holds and it currently lacks. Restored mail is handed back to the mail server, so the mailbox opens with its messages in place.

Restore mail folder as a new folder ​

Restore mail folder as a new folder brings back a single folder without touching the mailbox as it stands.

  • Mailbox - the mailbox the folder belongs to.
  • Folder - the folder to restore.

The messages are restored into a new folder named Restored-<date>-<folder>, after the date of the snapshot. Nothing in the mailbox is overwritten, and you can pick individual messages out of the new folder in your mail client. Restore the same folder from two snapshots and each restore gets a folder of its own.

Starting a backup ​

Backup now takes a snapshot on demand. You are asked to confirm.

The header shows how many manual backups you have left today. When the daily allowance is used up, the page says so, and the scheduled backup still runs as normal. A backup already in progress has to finish before another can start.

When a backup does not start, the notification says why and what to do. When the server is busy with other backups, try again in a few minutes.

Over the API ​

Since panel 1.9.5, the client REST API restores a mailbox or a mail folder from the account's backups, as Restoring mail does. Files, databases, and Backup now stay on this page. The calls need the Backups feature in the hosting plan and an API key of the account; see API Keys.

Method and pathWhat it does
GET /api/client/backups/snapshotsThe restore points, newest first, and whether self-service restore is on.
GET /api/client/backups/snapshots/{snapshot}/mailboxesThe mailboxes a restore point holds, and whether each still exists.
GET /api/client/backups/snapshots/{snapshot}/mailboxes/{email}/foldersThe folders of a mailbox in that restore point.
POST /api/client/backups/mailbox-restoresRestore mailbox: snapshot_id and email, with password only for a mailbox that was deleted.
POST /api/client/backups/mail-folder-restoresRestore mail folder as a new folder: snapshot_id, email, and folder.
GET /api/client/backups/restore-jobs, GET /api/client/backups/restore-jobs/{id}The recent restores and how each one ended.

A restore runs in the background and answers 202 with the restore job to follow. The rules are this page's: a password sent for a mailbox that still exists, or left out for one that was deleted, answers 422, and so does a restore point, mailbox, or folder the backup does not hold. A restore while another one runs, or before the waiting time between restores has passed, answers 409 with the wait. Without a backup policy, or without self-service restore, the calls are refused with the same message as the page. An administrator or reseller key acting on the account is not held to self-service restore or the waiting time.