// troubleshooting guide · apache superset

Superset SQL Lab Query Timeout

Status
Workaround available
platforms:
Self-hosted
updated:
November 16, 2026
reports:
3
Method
how we research
Share

RUNBOOK · apache-superset/sql-lab-query-timeout4 FIXES

// quick answer

SQL Lab queries stop at the synchronous web timeout or at SQLLAB_ASYNC_TIME_LIMIT_SEC when run async. For long queries, enable async execution with Celery and a RESULTS_BACKEND, and raise the limits.

Most likely fix: Enable async queries

How to fix it

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

  1. FIX 1Enable async queries

    1. 01Edit the database > Advanced > Performance and check 'Asynchronous query execution'
    2. 02Run Celery workers with the same config as the web app
    Did this fix it?
  2. FIX 2Configure a results backend

    1. 01Set RESULTS_BACKEND (e.g. RedisCache) in superset_config.py
    2. 02Restart the web app and workers
    Did this fix it?
  3. FIX 3Raise the limits

    1. 01Increase SQLLAB_ASYNC_TIME_LIMIT_SEC for async queries
    2. 02For sync queries align SUPERSET_WEBSERVER_TIMEOUT, Gunicorn and proxy timeouts
    Did this fix it?
  4. FIX 4Make the query lighter

    1. 01Add a LIMIT or narrower date filter
    2. 02Query a pre-aggregated table
    Did this fix it?

SANDBOX · apache-superset RUNS IN YOUR BROWSER

Try it: browse a sample shop and watch visitors, funnels and live data arrive

A hands-on Apache Superset-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.

Symptoms

'SQL Lab timeout' errors, 504s on long queries, or 'results backend is not configured' when running async.

Why it happens

  • C-01Query longer than the web server/proxy timeout in sync mode
  • C-02SQLLAB_ASYNC_TIME_LIMIT_SEC reached
  • C-03Async enabled without a RESULTS_BACKEND
  • C-04Celery workers not running or not sharing the results backend

// this guide also covers

  • superset sql lab timeout
  • superset results backend not configured
  • superset async query
  • SQLLAB_ASYNC_TIME_LIMIT_SEC

Still not working?

If Apache Superset keeps failing, you're not alone. See every Apache Superset problem users report or the alternatives people switch to.

Done fighting Apache Superset? Our small team builds your own Apache Superset alternative, or any software you need: web, mobile, games, desktop. Price agreed together.

Talk to us

Watch Apache Superset 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 not loading, error messages & connection guides →

Other Apache Superset errors

All 14 Apache Superset errors and fixes →