Database Settings Print

  • database, backup
  • 0

Medusa Panel › Settings › Database Settings

The Database Settings screen in the Medusa Streaming Engine manages the database backups of the panel. It lists every backup the engine holds, lets you create one on demand, protect or remove backups, download a copy, and restore the panel from a backup. Open it from the sidebar under Settings › Database Settings (/database/settings).

The lifecycle of automatic backups (how often they run, how many are kept, and a post-backup script) is configured on the Database tab of System Settings, not here. This screen is where you work with the resulting backup files. See the System Settings article for those options.

The backup list

Each row is one backup file, with these columns:

  • SHA1 — the checksum embedded in the backup, used to verify integrity.
  • Date — when the backup was taken, for example 2026-01-20 03:00:00.
  • Size — the file size, shown in readable units such as 8.8 kB or 127 MB.
  • Version — the engine version that produced the backup.
  • Source — how the backup was created: Automatic (a scheduled backup), Manual (created from this screen), or Installer (taken during installation or upgrade).
  • Keep When Rotate — whether the backup is protected from automatic rotation (see below).

You can search and sort by column to find a specific backup.

Creating and managing backups

The toolbar Mass Action menu above the list holds the actions that apply to the whole screen or to selected rows:

  • Backup Now — creates a fresh manual backup immediately. On success the engine reports the new file name.
  • Restore From File — opens the Database Restore dialog so you can upload a backup from your computer (see the restore section).
  • Mass Delete — deletes every backup you have selected with the row checkboxes.

Each row also has its own actions:

  • Download — downloads the backup as a .gz archive.
  • Restore — restores the panel from this listed backup (see the restore section).
  • Delete — removes this one backup after a confirmation.
  • Keep When Rotate — a toggle that protects the backup from automatic rotation.

Rotation and protection

Automatic rotation keeps only a set number of unprotected automatic backups; the limit is Database Max Backups on the System Settings Database tab. Cleanup runs after a successful scheduled backup.

Rotation removes only unprotected automatic backups. Manual and installer backups are always kept until you delete them. Turning on Keep When Rotate protects an automatic backup from rotation, but it does not stop you from deleting that backup by hand.

Restoring the panel

You can restore from a backup already in the list using its Restore action, or from a file on your computer using Restore From File. In the dialog, click or drop a .gz backup file, then press Upload; only .gz files are accepted and the archive is validated before it is used.

Once a restore is accepted, the engine schedules it and the panel restarts within a few seconds to apply the backup.

A restore replaces the current database contents with the backup. Take a fresh Backup Now first if you might need to return to the present state, and expect a brief restart while the restore runs.

Related


Was this answer helpful?

« Back