// troubleshooting guide · darktable

darktable OpenCL Not Working

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

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

  1. FIX 1Check OpenCL in the log

    1. 01Run darktable -d opencl
    2. 02Look for 'could not be initialised' or device errors
    Did this fix it?
  2. FIX 2Update drivers and darktable

    1. 01Install the latest GPU driver
    2. 02Update to darktable 5.6.2 or newer
    Did this fix it?
  3. FIX 3Clear the kernel cache

    1. 01Close darktable
    2. 02Delete the cached kernels folder in the darktable cache directory
    3. 03Restart so kernels recompile
    Did this fix it?
  4. FIX 4Disable OpenCL

    1. 01Start with darktable --disable-opencl
    2. 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

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 →