SQLite to PostgreSQL Migration¶

DUMB provides a guarded tool for moving an existing supported service from SQLite to DUMB-managed PostgreSQL. Open the service page and select Database Migration.

This tool is deliberately separate from postgres_enabled. For most services, enabling PostgreSQL directly changes the database used at the next start; it does not copy existing SQLite data. InfiniDysk additionally blocks a direct provider switch when an existing main SQLite database is present.

Supported services¶

Services that use PostgreSQL only, such as mediastorm, Riven Backend, Zilean, and Traefik Proxy Admin, do not have a SQLite source to migrate. Services without a confirmed PostgreSQL backend are not offered the tool.

What DUMB automates¶

The workflow:

1. Confirms that the service is enabled, still configured for SQLite, and has a healthy SQLite source.
2. Verifies PostgreSQL connectivity, database-creation privileges, and storage for staging plus backups.
3. Creates consistent SQLite backups with SQLite's backup API and verifies each copy.
4. Lets the service create its current schema in isolated PostgreSQL staging databases. For InfiniDysk, DUMB runs only the installed v1.2 backend's --db-migration maintenance command with an isolated configuration path; it never boots the normal application against staging.
5. Imports data into that schema, converts values according to PostgreSQL target types, resets sequences, and compares every imported table's row count.
6. For cutover, clones the validated application schema into the named production databases, imports a fresh cold snapshot, and enables postgres_enabled only after validation succeeds.
7. Restores the saved application configuration and SQLite mode automatically if cutover fails.

Jobs and backups remain in the original compatibility location:

/config/arr-postgres-migration/
├── jobs/
└── backups/

Existing Sonarr/Radarr job history and rollback backups therefore remain visible after upgrading. DUMB never deletes the source SQLite database.

Recommended flow¶

1. Run preflight¶

Open Database Migration on the service page and review every check. A failure blocks the job. A warning requires review but may be expected, such as a version that cannot be detected or a target database that already contains data.

The panel shows the latest persisted job for the current service, including its service name and start time. Historical failed or completed jobs remain visible after navigation and restarts; opening a panel or running preflight does not start a migration.

Preflight does not change the service configuration.

2. Run a rehearsal¶

Rehearsal is required before dmbdb enables cutover. It:

• takes a consistent SQLite snapshot;
• lets the service initialize isolated PostgreSQL staging databases;
• leaves InfiniDysk on its existing SQLite runtime throughout the rehearsal (a running instance stays running and a stopped instance stays stopped);
• performs the longer import against staging;
• validates all table counts and selected high-value tables; and
• removes the staging databases.

Other supported services may need a short schema-bootstrap interruption. InfiniDysk uses its migration-only maintenance command instead because its normal v1.2 runtime starts background cleanup and integration services. Do not restart DUMB or manually start/stop the service while a job is active.

Closing the migration popup does not cancel an active job. dmbdb asks for confirmation, then keeps a Database migration running in the background indicator on the service page with current progress and an Open progress action. For InfiniDysk, the 99% finalizing stage remains active while DUMB writes the durable PostgreSQL cutover authorization; the indicator and polling remain in place until the backend publishes a terminal result. Reopen the panel at any time to resume the detailed event view. Do not restart the DUMB API or container while the job is active.

When a guarded cutover finishes, the panel displays Migration completed successfully — PostgreSQL cutover is complete. If it finishes while the popup is closed, the service page replaces the running indicator with a dismissible completion notice. This confirms that DUMB imported and validated the snapshot and switched the database configuration; still verify service health, application data, and integrations afterward.

When validation succeeds, the panel displays Rehearsal passed — ready for PostgreSQL cutover and automatically selects Cut over to PostgreSQL. The service is still using SQLite at this point. Review the safeguards, enter the confirmation text again, and click Start guarded cutover to perform the actual switch.

3. Run guarded cutover¶

Cutover stops the service, creates a fresh cold backup, resets the named PostgreSQL target databases, imports and validates the snapshot, switches the application configuration, and starts the service when it was running before the job. InfiniDysk cutover is stricter: the SQLite service must already be running with healthy /health and /ready responses, and DUMB requires the PostgreSQL service to remain healthy after restart before declaring success.

Downtime depends mainly on SQLite size and storage speed.

4. Validate the application¶

Check the service's important objects and integrations, then perform a harmless write such as saving an unchanged setting. For an Arr, verify libraries, files, root folders, profiles, indexers, download clients, and history. For Bazarr, verify shows/movies, providers, history, and subtitle searches. For request services, verify users, requests, settings, and integrations.

For InfiniDysk, verify its UI plus provider, queue, and history state; confirm WebDAV or rclone access and Arr category/download-client behavior; and test representative playback and seeking. Confirm metrics.sqlite, warden.db, and usenet-migration.db remain healthy local files.

Keep the SQLite backup until PostgreSQL and its backup schedule have been proven with a test restore.

Arr log databases are optional¶

The five Arr services have a separate logs.db. Leave Migrate the service log database too disabled unless old application log entries matter. The main database already contains application configuration, library state, and history; starting fresh for diagnostic logs shortens cutover.

The option is hidden for Bazarr, Pulsarr, Seerr, AltMount, and InfiniDysk because they have one migrated main SQLite database.

Rollback behavior¶

For a completed cutover, the panel can restore the preserved application configuration, set postgres_enabled: false, and restart against the untouched SQLite database.

For InfiniDysk, rollback restores only the preserved main db.sqlite state; the three auxiliary SQLite stores never move. DUMB blocks directly toggling postgres_enabled off after a guarded cutover; use the migration job's explicit rollback action so the preserved source is validated before restart.

An active database-migration job is marked interrupted if the DUMB API restarts. Do not toggle postgres_enabled, replace db.sqlite, or restore the whole backup bundle manually. Reopen Database Migration and use the guarded rollback action whenever the job exposes it. For InfiniDysk, an interrupted, failed, or rollback_failed result remains visible as a red service-page recovery banner after the popup closes or the page reloads. The banner reopens the persisted job and does not disappear merely because background polling reached a terminal error.

A terminal rollback_failed result has two distinct recovery meanings:

• rollback.retry_safe: true means DUMB stopped before changing saved data. The guarded rollback remains available and may be retried after fixing the reported blocker.
• rollback.retry_safe: false means rollback had already started changing state. DUMB treats this as manual-attention recovery and freezes InfiniDysk lifecycle/provider changes. Review the private job evidence and the precise failed recovery surface before taking a targeted action; do not blindly restore the complete bundle or force the provider toggle.

PostgreSQL backups after migration¶

Application-native backups generally do not contain PostgreSQL data. Configure scheduled pg_dump backups for every migrated database by following the pgAdmin and pgAgent example, including retention and restore testing. Also protect the mounted data directory's postgres subtree (container path /data/postgres, service path /postgres_data) with the normal backup plan.

For InfiniDysk, also retain an independent filesystem backup of its complete configuration directory so the auxiliary SQLite stores, blobs, session.key, and other local state are protected alongside the PostgreSQL logical backup.

Upstream references¶

• Sonarr PostgreSQL setup
• Radarr PostgreSQL setup
• Lidarr PostgreSQL setup
• Prowlarr PostgreSQL setup
• Whisparr PostgreSQL setup
• Bazarr PostgreSQL database
• Pulsarr SQLite-to-PostgreSQL migration
• Seerr database configuration and migration
• InfiniDysk PostgreSQL guide
• InfiniDysk native migration tracking issue #1012