Back to all templates
Apache Superset logo

Apache Superset

Application2048MB+ RAM

Modern data exploration and visualization platform

analyticsbivisualizationdashboards

Deploy Apache Superset in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Apache Superset

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Apache Superset on a VPS with Server Compass

Use the Apache Superset template in Server Compass to deploy a self-hosted business intelligence and analytics platform with PostgreSQL metadata storage on your VPS, then verify the Apache Superset web UI in a browser.

About 7 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select your VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Apache Superset app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for Apache Superset

Use the template picker search to find Apache Superset in the Server Compass template catalog.

Searching for Apache Superset in the Server Compass template picker
4
Step 4

Select the Apache Superset template

Choose the Apache Superset template. Server Compass fills in the Apache Superset web service, PostgreSQL metadata database, generated database password, and mapped browser port.

Apache Superset template selected in Server Compass
5
Step 5

Review the Apache Superset settings

Confirm the app name and compose services. In this run, the app was named superset-demo and used host port 8088.

Reviewing Apache Superset project settings and compose services
6
Step 6

Deploy Apache Superset

Review the generated environment values, confirm the port is available, and click Deploy Now.

Reviewing Apache Superset environment variables and port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Apache Superset image, starts the container, and verifies the stack.

Server Compass deploying the Apache Superset template on the VPS
8
Step 8

Confirm Apache Superset is running

After deployment finishes, return to the Apps tab and confirm the Apache Superset app is marked Running with its application URL available.

Apache Superset template running in the Server Compass Apps tab
9
Step 9

Open Apache Superset in the browser

Open the application URL in a browser. The Apache Superset login page confirms the analytics app is reachable after the template bootstrap completes.

The deployed Apache Superset web UI loaded in a browser

After Apache Superset Opens

  • Log in with the generated admin password, rotate it for production, and create named user accounts.
  • Configure HTTPS, database access, backups, roles, and permissions before inviting users.
  • Back up the Apache Superset PostgreSQL metadata volume before relying on saved dashboards or questions.

Verified Result

The Apache Superset web UI loaded successfully in a browser.

Apache Superset deployment questions

What does the Apache Superset template deploy?

It deploys Apache Superset with PostgreSQL metadata storage and Redis for the Superset runtime.

Which port did the tutorial use?

The tutorial used host port 8088, which maps to the Apache Superset web service on container port 8088.

Why does the guide stop at the login web UI?

The template already runs migrations and creates the initial admin account. The tutorial stops at the clean login page because production database connections, roles, dashboards, and HTTPS depend on the instance.

Should this become a blog post?

No. The deployment guide should live on the Apache Superset template detail page and be linked from the reusable template deployment docs page.

DIY Deployment

Self-Host Apache Superset with Docker

Take the DIY route and deploy Apache Superset on your own server using Docker.

1

Log into Your Server

Access your server's command line by opening a terminal and running the SSH command below.

terminal
# SSH into your server
ssh root@your-server-ip

# Using a custom SSH key
ssh -i ~/.ssh/id_rsa root@your-server-ip

First time? Need Docker? Install it: curl -fsSL https://get.docker.com | sh

2

Prepare the Install Location

Set up the folder structure for your Docker deployment.

terminal
# Create and navigate to project directory
mkdir -p ~/apps/superset
cd ~/apps/superset
3

Create docker-compose.yml

Set up your Docker Compose file with this configuration:

docker-compose.yml
services:
  superset:
    image: apache/superset:latest
    ports:
      - "8088:8088"
    environment:
      - SUPERSET_SECRET_KEY=<your-secret-key>
      - DATABASE_DIALECT=postgresql
      - DATABASE_HOST=db
      - DATABASE_PORT=5432
      - DATABASE_DB=superset
      - DATABASE_USER=superset
      - DATABASE_PASSWORD=<your-db-password>
      - REDIS_HOST=redis
      - REDIS_PORT=6379
    volumes:
      - superset_home:/app/superset_home
    restart: unless-stopped
    depends_on:
      - db
      - redis

  db:
    image: postgres:16-alpine
    environment:
      - POSTGRES_USER=superset
      - POSTGRES_PASSWORD=<your-db-password>
      - POSTGRES_DB=superset
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

  redis:
    image: redis:7-alpine
    restart: unless-stopped

volumes:
  superset_home:
  postgres_data:
Configurable Options
PORTHost port(default: 8088)
SECRET_KEYSecret key
DB_PASSWORDDB password
4

Run the Deployment

Start all services defined in your compose file.

terminal
# Start the containers in detached mode
docker compose up -d

# Check if containers are running
docker compose ps

# View logs
docker compose logs -f
5

Configure Network Access

Open the port so you can access the application externally.

terminal
# Allow the application port through firewall
sudo ufw allow 8088/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:8088
Skip the Terminal

Want one-click deploys? Try Server Compass.

Forget SSH and YAML files. Deploy Apache Superset visually with Server Compass in just a few clicks.

  • Visual configuration UI
  • One-click deployment
  • Automatic SSL setup
  • Zero-downtime updates
  • Built-in monitoring
  • One-click rollbacks
Download Server Compass$29 one-time • Lifetime license

After Deployment

After deploying Apache Superset with Server Compass, complete these steps to finish setup

1

Create admin user

2

Run: superset db upgrade

3

Run: superset init

Need help? Check out our documentation for detailed guides.

Apache Superset FAQ

Common questions about self-hosting Apache Superset

How do I deploy Apache Superset with Server Compass?

Simply download Server Compass, connect to your VPS, and select Apache Superset from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Apache Superset?

Apache Superset requires a minimum of 2048MB RAM. We recommend a VPS with at least 4096MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Apache Superset data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Apache Superset backup and restore procedures.

How do I update Apache Superset to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Apache Superset image will be pulled and deployed with zero downtime.

Is Apache Superset free to self-host?

Apache Superset is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host Apache Superset?

Download Server Compass and deploy Apache Superset to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass