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 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 kBor127 MB. - Version — the engine version that produced the backup.
- Source — how the backup was created:
Automatic(a scheduled backup),Manual(created from this screen), orInstaller(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
.gzarchive. - 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.
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.