// troubleshooting guide · apache superset
Superset Alerts and Reports Not Sending Emails
- Status
- Workaround available
- platforms:
- Self-hosted, Docker, Kubernetes
- updated:
- November 16, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · apache-superset/alerts-reports-not-sending5 FIXES
// quick answer
Superset reports usually fail silently because the ALERT_REPORTS flag, Celery beat schedule, headless browser or SMTP is not set up, or dry-run mode is still on. Check the worker logs first.
Most likely fix: Enable the feature and scheduler
How to fix it
// try these in order, the most common fix is first
FIX 1Enable the feature and scheduler
- 01Add 'ALERT_REPORTS': True to FEATURE_FLAGS
- 02Add reports.scheduler to CeleryConfig.beat_schedule (every minute)
- 03Run exactly one celery beat and at least one celery worker
Did this fix it?FIX 2Turn off dry run
- 01Set ALERT_REPORTS_NOTIFICATION_DRY_RUN = False
- 02Restart the worker and beat
Did this fix it?FIX 3Point the worker at Superset
- 01Set WEBDRIVER_BASEURL to the internal URL (e.g. http://superset:8088 in Docker, not localhost)
- 02Set WEBDRIVER_BASEURL_USER_FRIENDLY to the public URL
- 03curl the report URL from the worker container to test
Did this fix it?FIX 4Fix screenshots
- 01Use the default image, not -lean or -dev, so Playwright and Chromium are included
- 02Look for 'Playwright is required' or 'Failed to launch the headless browser' in logs
Did this fix it?FIX 5Test SMTP
- 01Set SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, SMTP_MAIL_FROM
- 02Send a test email from a Python shell in the worker
- 03A 'Connection timed out' usually means the host blocks the SMTP port
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
Scheduled reports show as working or failed but no email or Slack message arrives, the Alerts & Reports menu is missing, or screenshots are blank.
Why it happens
- C-01ALERT_REPORTS feature flag not enabled
- C-02No reports.scheduler entry in the Celery beat_schedule
- C-03ALERT_REPORTS_NOTIFICATION_DRY_RUN still True (dev default)
- C-04Worker cannot reach WEBDRIVER_BASEURL
- C-05Playwright/Chromium missing in lean images
- C-06SMTP blocked or misconfigured
// this guide also covers
- superset alerts and reports not working
- superset email report not sending
- superset reports celery beat
- superset scheduled reports
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 notifications, reminders & messages not sending guides →
Metabase Not Sending Emails or Alerts (Metabase)
Looker Studio Scheduled Email Not Sending (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 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)
- Superset Dashboards Broken After Upgrade