// troubleshooting guide · darktable
darktable Slow to Start
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux
- updated:
- November 17, 2026
- reports:
- 3
- Method
- how we research
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
FIX 1Disable the XMP scan
- 01Open preferences (gear icon) > storage > xmp
- 02Set 'look for updated XMP files on startup' to off
- 03Restart darktable
Did this fix it?FIX 2Move the library to an SSD
- 01Close darktable
- 02Copy library.db and data.db to an SSD folder
- 03Start darktable with --library /path/library.db
Did this fix it?FIX 3Run database maintenance
- 01Preferences > storage > database > enable 'create database snapshot' and maintenance
- 02Restart so the database is vacuumed
Did this fix it?FIX 4Test with a fresh workspace/config
- 01Start darktable with --configdir /tmp/dtcfg --library :memory:
- 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 usThe same problem in other apps
All slow, laggy or resource-hungry guides →
Lightroom Classic Running Slow (Adobe Lightroom)
DxO PhotoLab 'Low GPU Memory Detected' Warning (DxO PhotoLab)
Why Is Capture One So Slow? (Catalog Lag Fixes) (Capture One)
Why Is Affinity Photo So Slow (Affinity Photo)