--- title: "Deploy Superset [Updated Sep '26]" description: "Superset [Sep '26] (Self-Hosted Tableau/Looker Alternative)" category: "Analytics" url: https://railway.com/deploy/superset-apache --- # Deploy Superset [Updated Sep '26] Superset [Sep '26] (Self-Hosted Tableau/Looker Alternative) **[Deploy Superset [Updated Sep '26] on Railway](https://railway.com/template/superset-apache)** Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/superset-apache/manifest.json - **Creator:** shruistic - **Category:** Analytics ## Template content ### superset-beat https://raw.githubusercontent.com/ju-li/apache-superset-railway/main/logo.png - **Image:** apache/superset:latest - **Start command:** `/bin/sh -c "mkdir -p /app/pythonpath && echo \"$SUPERSET_CONFIG_B64\" | base64 -d > /app/pythonpath/superset_config.py && (command -v uv >/dev/null 2>&1 && uv pip install --no-cache-dir psycopg2-binary || pip install --no-cache-dir psycopg2-binary) && rm -f /tmp/celerybeat.pid && /app/docker/docker-bootstrap.sh beat"` ### redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg - **Image:** redis:8.2.1 - **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"` ### superset https://raw.githubusercontent.com/ju-li/apache-superset-railway/main/logo.png - **Image:** apache/superset:latest - **Start command:** `/bin/sh -c "mkdir -p /app/pythonpath && echo \"$SUPERSET_CONFIG_B64\" | base64 -d > /app/pythonpath/superset_config.py && /app/docker/docker-init.sh && /app/docker/docker-bootstrap.sh app-gunicorn"` - **Public domain:** Yes ### superset-worker https://raw.githubusercontent.com/ju-li/apache-superset-railway/main/logo.png - **Image:** apache/superset:latest - **Start command:** `/bin/sh -c "mkdir -p /app/pythonpath && echo \"$SUPERSET_CONFIG_B64\" | base64 -d > /app/pythonpath/superset_config.py && (command -v uv >/dev/null 2>&1 && uv pip install --no-cache-dir psycopg2-binary || pip install --no-cache-dir psycopg2-binary) && /app/docker/docker-bootstrap.sh worker"` ### postgres https://devicons.railway.app/i/postgresql.svg - **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18 ## Documentation # Deploy and Host Apache Superset Self-Hosted on Railway Apache Superset is the open-source answer to Tableau: a real production-grade business intelligence platform with SQL-based exploration, dashboards, and scheduled reports, run at genuine scale by companies like Airbnb, its original creator. This template deploys its full 5-service architecture, verified live end-to-end, not a stripped-down web-app-only setup. ## About Hosting Superset Self-Hosted Tableau Cloud's Standard edition runs $75/user/month for Creator seats, $42 for Explorer, $15 for Viewer, billed annually. A 10-person analytics team on Creator seats alone pays $750/month before adding any Explorer or Viewer licenses. Looker is worse for smaller teams: no public pricing, but real deployments start around $36,000-48,000/year. Superset self-hosted on Railway flips that entirely: a flat infrastructure cost regardless of how many people view or build dashboards. ## This Template Deploys Superset's Real Architecture, Built From a Proven Reference and Cross-Checked Against Upstream Superset isn't a single web container. Its production shape is 5 services: the web app, a Celery worker for background jobs like chart thumbnail rendering, a Celery beat scheduler for anything running on a schedule, Postgres for metadata, and Redis as the Celery broker and cache backend. This template deploys exactly that. Building it started differently from earlier templates in this series: instead of guessing configuration from documentation alone, I pulled Railway's existing reference template's actual serialized config directly via its API, then cross-checked every piece against Superset's own official `docker-compose-non-dev.yml`, `docker-init.sh`, and `docker-bootstrap.sh` scripts fetched live from GitHub. That combination, a proven working config plus the upstream source that explains *why* it works, is what let this build get 4 of the 5 services right on the first deploy. The fifth surfaced something real. Both the Celery worker and Celery beat services crash-looped immediately with `ModuleNotFoundError: No module named 'psycopg2'`. Digging into Superset's own `docker-bootstrap.sh`, the script explicitly skips installing Postgres driver requirements for worker and beat processes, "to avoid conflicts", installing `psycopg2` only for the main web process. That assumption holds when everything shares one locally-built image with the driver already baked in, but the published `apache/superset:latest` tag doesn't ship with `psycopg2` pre-installed, so any deployment running worker and beat as genuinely separate service instances against that tag hits this immediately. The existing Railway reference template doesn't have a fix for this either, worth knowing if you've deployed it and never checked whether your worker and beat processes were actually healthy versus just quietly crash-looping. The fix here installs `psycopg2-binary` explicitly in both start commands before invoking Superset's bootstrap script, confirmed live: the worker logs `celery@... ready.` connected to Redis, and beat logs `beat: Starting...`, both genuinely running, not just deployed. ## Common Use Cases - **Startups replacing Tableau or Looker to cut per-seat licensing**: Flat infrastructure pricing instead of $15-115 per user per month. - **Data teams that need real SQL-based exploration**: Superset's SQL Lab is a first-class feature, not an afterthought bolted onto a dashboard tool. - **Companies with data spread across multiple databases**: Native support for dozens of SQL backends from a single instance. - **Teams that need scheduled alerts and reports that actually run**: Backed by a genuinely working Celery beat scheduler, not just a checkbox in a settings page. ## Dependencies for Superset Self-Hosted Hosting Postgres for metadata (dashboards, charts, saved queries), Redis as the Celery broker and cache backend across 4 separate logical databases, and two Celery processes, worker and beat, alongside the web app itself. None of these are optional for a real production deployment; skipping the Celery processes means no async chart thumbnails and no scheduled reports. ### Deployment Dependencies This template deploys 5 services total. Considerably heavier than a typical single-container BI tool, but this is Superset's actual production shape. ### Reference Links Official documentation: superset.apache.org/docs. Source and issue tracker: github.com/apache/superset. Official Docker images: `apache/superset` on Docker Hub. ### Implementation Details All 3 Superset processes run `apache/superset:latest`. Configuration is injected via a base64-encoded `superset_config.py`, decoded at container start, wiring `DATABASE_URL` and `REDIS_URL` into Superset's config format with `ALERT_REPORTS`, `DASHBOARD_RBAC`, and `EMBEDDED_SUPERSET` feature flags enabled, and secure session cookie settings for production use. ## How Superset Compares to the Alternatives Against Tableau, the trade is infrastructure ownership for zero-setup convenience. Tableau Cloud requires nothing beyond a subscription; Superset requires deploying 5 services (which this template does in one click) in exchange for zero per-seat licensing and full data ownership. Against Looker, the difference is pricing transparency and floor. Looker has no public list price and real deployments start in the tens of thousands per year; Superset's cost is purely your infrastructure bill, no minimum contract size. Against Metabase, the closest open-source comparison, the real difference is scale and async architecture. Superset ships a genuine background job pipeline, Celery worker plus beat, for chart thumbnails and scheduled reports, proven at companies operating it at real production scale; Metabase's architecture is comparatively simpler. ## Getting Started Deploy the template, but set `ADMIN_PASSWORD` to a real generated value first, the reference config's own default is a broken placeholder, not something to use literally. Once deployed, open your domain (it redirects to `/login/`), log in as `admin` with that password, connect a database from Settings, and start building dashboards. ## Why Deploy Superset Self-Hosted on Railway? Because the two obvious alternatives, a per-seat BI subscription or manually wiring 5 Docker services yourself, both cost you something. Tableau and Looker's per-seat pricing scales against your team's growth regardless of actual dashboard usage. Manually deploying Superset means correctly wiring Postgres, Redis, and 3 separate Superset processes, and hitting real gaps like the worker/beat driver issue this build found and fixed, in ways that don't announce themselves clearly until you check whether your background jobs are actually running. This template does that wiring for you, verified against a real live deploy, not just a template that looked complete. Railway offers a $5 free trial so you can test your Superset deployment before committing to production use. ## Frequently Asked Questions ### Why did my Celery worker or beat process crash on startup? `apache/superset:latest` doesn't ship with the `psycopg2` Postgres driver pre-installed, and Superset's own bootstrap script explicitly skips installing it for worker and beat processes, assuming it's already present. Confirmed live via the actual traceback during this build. This template's start commands install `psycopg2-binary` explicitly before starting either process to fix this. ### Why does this template deploy 5 services instead of just the web app? Because that's Superset's real production architecture: a Celery worker and beat scheduler for background jobs and scheduled reports, alongside Postgres and Redis, verified directly against Superset's own official Docker Compose setup. ### What happens to my dashboards if I redeploy? Nothing, as long as the Postgres volume stays attached. All dashboards, charts, and saved queries live in the metadata database, not in any service's ephemeral filesystem. ### Is my data private? Yes. Every service runs on infrastructure you control, over Railway's private network. Superset itself connects out to whatever databases you configure as data sources; those credentials live in your own metadata database, not a third party's. ### How is this different from just using Tableau? Cost at scale, mainly. Tableau requires zero setup but bills $15-115 per user per month depending on role. This template gets you a comparable SQL-exploration-and-dashboard platform for a flat infrastructure cost. ### Do scheduled alerts and reports actually run, or are they just present in the config? They genuinely run: `ALERT_REPORTS` is enabled in the feature flags and a real, confirmed-healthy Celery beat scheduler triggers them on schedule, not just bundled and unverified. ### What databases can Superset connect to? Dozens of SQL backends via SQLAlchemy connectors: Postgres, MySQL, BigQuery, Snowflake, ClickHouse, and many more, all configurable from the admin UI after deploying. ## Similar templates - [Typesense vs Meilisearch](https://railway.com/deploy/typesense-vs-meilisearch) — self-hosted Typesense vs Meilisearch - [Betterlytics](https://railway.com/deploy/betterlytics) — Betterlytics is a cookieless analytics platform GDPR-compliant. - [Finance Tracker](https://railway.com/deploy/finance-tracker-1) — Private multi-user household finance ledger with budgets and CSV import. Open this page in a browser: https://railway.com/deploy/superset-apache