// 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
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
FIX 1Enable async queries
- 01Edit the database > Advanced > Performance and check 'Asynchronous query execution'
- 02Run Celery workers with the same config as the web app
Did this fix it?FIX 2Configure a results backend
- 01Set RESULTS_BACKEND (e.g. RedisCache) in superset_config.py
- 02Restart the web app and workers
Did this fix it?FIX 3Raise the limits
- 01Increase SQLLAB_ASYNC_TIME_LIMIT_SEC for async queries
- 02For sync queries align SUPERSET_WEBSERVER_TIMEOUT, Gunicorn and proxy timeouts
Did this fix it?FIX 4Make the query lighter
- 01Add a LIMIT or narrower date filter
- 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 usThe same problem in other apps
All not loading, error messages & connection guides →
Metabase Dashboard Slow or Not Loading (Metabase)
Power BI Gateway Offline or Could Not Be Reached (Microsoft Power BI)
Tableau "Unable to Start Due to an Internal Licensing Error" (Tableau)
Looker Studio GA4 Quota Exceeded Error (Looker Studio)
Other Apache Superset errors
- Superset CSRF Session Token Is Missing Error
- Superset Dashboard Slow or Charts Timing Out
- Superset Refusing to Start Due to Insecure SECRET_KEY
- Superset Alerts and Reports Not Sending Emails
- Superset Embedded Dashboard Not Loading (403 or Refused to Connect)
- Superset Could Not Load Database Driver
- Superset CSV Upload Option Missing
- Superset Forgot Admin Password (How to Reset Login)