// troubleshooting guide · darktable

darktable Slow to Start

Status
Workaround available
platforms:
Windows, macOS, Linux
updated:
November 17, 2026
reports:
3
Method
how we research
Share

RUNBOOK · darktable/slow-startup4 FIXES

// quick answer

darktable is usually slow to start because of a huge library, network storage, the XMP-on-startup scan or a Flatpak build. Turn off the startup XMP scan, keep the library on an SSD and run a database cleanup.

Most likely fix: Disable the XMP scan

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Disable the XMP scan

    1. 01Open preferences (gear icon) > storage > xmp
    2. 02Set 'look for updated XMP files on startup' to off
    3. 03Restart darktable
    Did this fix it?
  2. FIX 2Move the library to an SSD

    1. 01Close darktable
    2. 02Copy library.db and data.db to an SSD folder
    3. 03Start darktable with --library /path/library.db
    Did this fix it?
  3. FIX 3Run database maintenance

    1. 01Preferences > storage > database > enable 'create database snapshot' and maintenance
    2. 02Restart so the database is vacuumed
    Did this fix it?
  4. FIX 4Test with a fresh workspace/config

    1. 01Start darktable with --configdir /tmp/dtcfg --library :memory:
    2. 02If fast, the old database or settings are the cause
    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

darktable shows a splash or 'Initializing Lua' for a long time, from many seconds up to minutes.

Why it happens

  • C-01'Look for updated XMP files on startup' enabled
  • C-02Library database very large or on a slow disk
  • C-03Raw files on SMB/network storage
  • C-04Flatpak build startup overhead
  • C-05Corrupted file blocking thumbnail generation

// this guide also covers

  • darktable slow to start
  • darktable takes forever to open
  • darktable initializing lua hang

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

The same problem in other apps

All slow, laggy or resource-hungry guides →

Other darktable errors

All 12 darktable errors and fixes →