// 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
Share

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

  1. FIX 1Restore a snapshot

    1. 01Close darktable
    2. 02Copy a library.db-snp-* snapshot made before upgrading over library.db
    Did this fix it?
  2. FIX 2Back up before upgrading

    1. 01Copy library.db and data.db and darktablerc before installing a major version
    Did this fix it?
  3. FIX 3Stay on the new version and update

    1. 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

Watch darktable Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other darktable errors

All 12 darktable errors and fixes →