darktable Not Working? Common Errors & Fixes
The 12 darktable problems users hit most often, why they happen, and the fixes that actually work — collected from user reports, forums, and official support docs.
darktable Slow to Start
Workaround availableWindows, macOS, Linuxdarktable 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.
darktable Crashes on Import
Workaround availableWindows, macOS, Linuxdarktable usually crashes on import because of one corrupted or unsupported RAW or thumbnail generation. Import folder by folder to find the bad file and capture a log with darktable -d all.
darktable OpenCL Not Working
Workaround availableWindows, macOS, LinuxIf darktable OpenCL fails, shows black images or crashes, update the GPU driver and darktable (5.6.2 fixed Intel Compute Runtime 26.35), clear the OpenCL kernel cache, or disable OpenCL.
darktable Black Image on Export or in Darkroom
Workaround availableWindows, macOS, LinuxA black image in darktable is most often an OpenCL bug. Disable OpenCL or the offending module (haze removal, filmic or sigmoid on some GPUs), update drivers and retry the export.
darktable Database Locked Error
Fixed in latest versionWindows, macOS, Linux'Database is locked' means stale lock files remain from a crash or another darktable process is using the library. Close darktable and delete data.db.lock and library.db.lock only when no darktable process is running.
darktable Not Opening on Mac
Workaround availablemacOSIf darktable won't open on a Mac, check you have an Apple silicon build for macOS 13.5 or newer, allow it in Privacy & Security, and launch from Terminal to see the error.
darktable Slow in Darkroom
Workaround availableWindows, macOS, Linuxdarktable is slow in darkroom when OpenCL is off, RAM is low or heavy modules (diffuse or sharpen, denoise, AI) are enabled. Enable OpenCL, raise the tile and memory settings, and disable heavy modules while editing.
darktable Export Failed or Could Not Export
Workaround availableWindows, macOS, Linuxdarktable export errors are usually folder permissions or a metadata-writing failure. Export to a writable folder, simplify the filename template and check the log.
darktable Unsupported Camera or RAW Not Opening
OngoingWindows, macOS, LinuxIf darktable won't open RAW from a new camera, the model probably is not supported yet. Update to the latest release or nightly, check the supported camera list, or convert to DNG.
darktable Import Lightroom Catalog and Edits
OngoingWindows, macOS, Linuxdarktable cannot import Lightroom catalogs or edits. Import the RAW files (or exported DNG/TIFF), then re-edit; XMP ratings and keywords can often be read.
darktable Colors Look Wrong or Different from Camera JPEG
Workaround availableWindows, macOS, Linuxdarktable photos look flat or off compared with the camera JPEG because it uses a scene-referred pipeline and a neutral default. Use color calibration, filmic or AgX, and a camera style or input profile.
darktable Upgrade Breaks Library or Won't Open Older Version
Workaround availableWindows, macOS, LinuxA new darktable version upgrades the library, so older versions refuse to open it. Restore the backup or snapshot taken before upgrading.
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. 1-2 minutes, nothing is saved.
Problem not listed? See all darktable complaints or compare darktable alternatives.
// We build software. Any software.
Have an idea for an app? We'll build it.
We're a small team of developers who build custom software fast. Not just tools like darktable: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code