// troubleshooting guide · darktable
darktable OpenCL Not Working
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux
- updated:
- November 17, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · darktable/opencl-not-working4 FIXES
// quick answer
If 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.
Most likely fix: Check OpenCL in the log
How to fix it
// try these in order, the most common fix is first
FIX 1Check OpenCL in the log
- 01Run darktable -d opencl
- 02Look for 'could not be initialised' or device errors
Did this fix it?FIX 2Update drivers and darktable
- 01Install the latest GPU driver
- 02Update to darktable 5.6.2 or newer
Did this fix it?FIX 3Clear the kernel cache
- 01Close darktable
- 02Delete the cached kernels folder in the darktable cache directory
- 03Restart so kernels recompile
Did this fix it?FIX 4Disable OpenCL
- 01Start with darktable --disable-opencl
- 02Or preferences > processing > CPU/GPU/memory > set OpenCL off
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
Darkroom or exports are black, darktable reports OpenCL disabled, or it freezes with a driver timeout.
Why it happens
- C-01Outdated or buggy GPU driver
- C-02Intel Compute Runtime platform rename (fixed in 5.6.2)
- C-03Module-specific GPU bug (e.g. haze removal, filmic, sigmoid)
- C-04Stale kernel cache
- C-05Not enough VRAM
// this guide also covers
- darktable opencl not working
- darktable opencl black image
- darktable opencl crash
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