“Database Migration Error” on Fresh Install (macOS)

Issue: On first launch, a new installation of Sample Manager shows a “Database migration error” — even before importing samples.

Cause: The app fails to create or upgrade the database due to macOS file permission issues, especially in newer versions of macOS.

Fix:

1. Quit Sample Manager completely. Ensure it’s not running in the background.
2. Delete the database file manually:

• Go to: ~/Library/Application Support/ADSR
• Delete any .db3 files you see in this folder.

1. Reopen Sample Manager. It will attempt to create a fresh database on launch.

Optional: On macOS Ventura or later, grant Full Disk Access to Sample Manager:

• Go to System Settings → Privacy & Security → Full Disk Access
• Add ADSR Sample Manager.app manually if it’s not listed

Why This Happens:

• Newer versions of macOS may restrict database creation if folder permissions are not inherited properly during installation.
• A partially created database file can also trigger migration errors on launch.