Restore and Migrate

The first setup screen offers three paths:

• Set Up From Scratch: save new Stackarr paths, services, credentials, automation, and presets.
• Restore From Backup: upload a Stackarr backup archive and queue a guarded restore.
• Migrate Current Stack: scan for supported existing services and copy their config/database state into Stackarr.

Restore From Backup

Stackarr scheduled backups are written as .tar.gz archives. The restore workflow also accepts .tgz and .zip archives so users can restore backups that were repackaged by other tools.

Onboarding restore queues:

stackarr backup restore /path/to/archive.tar.gz --yes --force-config --mark-onboarding-complete

The app adds explicit restore or skip choices for shared Postgres and existing Plex host data based on the selected checkboxes.

Use shared Postgres restore when the archive contains database/*.dump and the new install should replace matching Stackarr-managed databases. Leave existing Plex host options off unless restoring onto the same host or a carefully prepared replacement host.

Migrate Current Stack

Migration has a dry-run plan first:

stackarr migrate plan

To point Stackarr at a conventional folder layout instead of Docker discovery:

stackarr migrate plan --source-root /absolute/path/to/existing-stack

Confirmed migration copies supported service config directories into Stackarr and marks onboarding complete:

stackarr migrate run --yes

By default, Docker-discovered source containers are stopped while copying and restarted afterward. This keeps SQLite-backed apps such as Radarr, Sonarr, Lidarr, Prowlarr, and Bazarr from being copied mid-write. Use --no-stop-source only after stopping services yourself or accepting the risk of inconsistent live database files.

Supported migration targets include Radarr, Radarr 4K, Sonarr, Sonarr 4K, Prowlarr, Lidarr, Bazarr, Seerr/Overseerr/Jellyseerr, Pulsarr, Transmission, qBittorrent, Plex, Jellyfin, TinyMediaManager, Recyclarr, Tidarr, and BookOrbit.

Moving to another Docker host

Docker-managed service config is portable when media and download paths are equivalent or updated after restore.

Existing media servers are different. Host certificates, hostnames, hardware devices, preferences, and absolute paths remain tied to the original machine. Restore those pieces only to a compatible host layout, or reconnect the server manually after Stackarr is running.