// troubleshooting guide · darktable
darktable Upgrade Breaks Library or Won't Open Older Version
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux
- updated:
- November 17, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · darktable/upgrade-library-incompatible3 FIXES
// quick answer
A new darktable version upgrades the library, so older versions refuse to open it. Restore the backup or snapshot taken before upgrading.
Most likely fix: Restore a snapshot
How to fix it
// try these in order, the most common fix is first
FIX 1Restore a snapshot
- 01Close darktable
- 02Copy a library.db-snp-* snapshot made before upgrading over library.db
Did this fix it?FIX 2Back up before upgrading
- 01Copy library.db and data.db and darktablerc before installing a major version
Did this fix it?FIX 3Stay on the new version and update
- 01Install 5.6.2 to benefit from fixes instead of downgrading
Did this fix it?
SANDBOX · darktable RUNS IN YOUR BROWSER
Try it: edit a layered image, paint, generate and export it
A hands-on darktable-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
After updating, darktable shows a newer database version message or the old install won't start.
Why it happens
- C-01Library schema upgraded by 5.6
- C-02Downgrade attempt
// this guide also covers
- darktable upgrade library incompatible
- darktable downgrade
- darktable database version
Still not working?
If darktable keeps failing, you're not alone. See every darktable problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to us