Backup

Backup

🌐 English · Deutsch

The Backup tab (Settings → Backup, admin only) provides full and selective backup/restore as a single .mfbackup file — a JSON envelope, format version 1. Caches are never included.

Categories

You choose per category what goes into the backup:

Category	Default
Settings	on
Favorites (incl. ignored media & hidden Seerr entries)	on
Download history	on
Watch progress	on
Custom paths	on
Users (incl. per-user notification preferences)	on
Queues (download / autosync / encoding / upscale)	off
Calendar data	off
Push subscriptions	off

Modules can add their own categories to this list.

Backup password and secrets

By default a backup password is required — for export and, for an encrypted backup, for import.

Normal values are stored as plain text in the file. Sensitive settings (API keys etc.) are re-encrypted for the backup with a key derived from the password (PBKDF2-SHA256, 600,000 iterations). On import they are re-encrypted with the target installation's own key — backups are therefore portable between installations. Keep the password safe: without it an encrypted backup cannot be restored.

Saving without a password (insecure)

An opt-in "Save backup without a password" checkbox lets you skip the password. After confirming a warning, the backup is written unencrypted: all sensitive values — API keys, credentials, tokens and passwords — are stored as plain text and anyone with the file can read them. Such a backup imports without a password. Only use this for a throwaway/offline copy you keep protected yourself — never for cloud, email or shared storage.

Import

Upload the .mfbackup file; a preview shows what the backup contains before anything is restored. Then choose the categories and one of two modes:

Mode	Behavior
Merge	Existing rows/keys are overwritten where they collide; everything else is kept
Replace	The selected categories are wiped first, then restored from the backup

Oversized files are rejected.