> Source: https://meetrix.io/blogs/superset-developer-guide/
> Markdown copy of that page. Cite the URL above, not this file.

Development

# Superset - Developer Guide

[By Binuka Ranatunga](https://meetrix.io/blogs/authors/binuka-ranatunga/) • September 5, 2025 • 8 min read

Learn how to install and configure Apache Superset on AWS with our step-by-step deployment guide. This comprehensive resource walks you through provisioning your cloud environment, securely deploying Superset, and optimizing it for scalability, high availability, and performance on AWS. Whether you're building interactive dashboards, running complex analytics, or managing large-scale data visualizations, this guide will help you set up and run Superset efficiently in the cloud.

Welcome to the Superset Deployment Guide for AWS Integration! Unlock the full potential of Apache Superset, the open-source business intelligence and data visualization platform. Seamlessly integrate with your AWS infrastructure to achieve enterprise-grade scalability, secure access, and DevOps-friendly automation. Empower your teams with interactive dashboards, real-time analytics, and extensibility for mission-critical insights. Let's get started and elevate your data visualization and decision-making with Superset on AWS.

## Video Guide

Prerequisites

Before you get started with the Superset AMI, ensure you have the following prerequisites:

-   Basic knowledge of AWS services, including EC2 instances and CloudFormation.
-   An active AWS account with appropriate permissions.
-   Enough vCPU limit to create an instance (Follow [https://meetrix.io/blogs/increase-aws-vcpu-quota/](https://meetrix.io/blogs/increase-aws-vcpu-quota/)).

## Launching the AMI

### Step 1: Find and Select Superset AMI

1.  Log in to your AWS Management Console.
2.  Navigate to the '[Superset](https://aws.amazon.com/marketplace/pp/prodview-aeclrnbo27hxa)' in AWS Marketplace.

### Step 2: Initial Setup & Configuration

1.  Click the **"Continue to Subscribe"** button.
2.  After subscribing, accept the terms and click **"Accept Terms"**.
3.  Wait a few minutes until processing completes, then click **"Continue to Configuration"**.
4.  Select **"CloudFormation script to deploy Superset"** as the fulfillment option and choose your region. Click **"Continue to Launch"**.
5.  From the "Choose Action" dropdown, select **"Launch CloudFormation"** and click **"Launch"**.

## Create CloudFormation Stack

### Step 1: Create a stack

1.  Ensure the **"Template is ready"** option is selected under "Prepare template".
2.  Click "Next".

### Step 2: Specify stack options

1.  Provide a unique **"Stack name"**.
2.  Enter a value for **"DeploymentName"**.
3.  Provide a public domain for **"DomainName"**. Superset will automatically try to set up SSL if the domain is hosted on Route53. If unsuccessful, you must set up SSL manually.
4.  Choose an instance type **"InstanceType"** (Recommended: **t3a.large**).
5.  Enter Superset username for login.
6.  Enter Superset password for login.
7.  Select your preferred **"keyName"**.
8.  Set **"SSHLocation"** to 0.0.0.0/0.
9.  Keep **"SubnetCidrBlock"** as 10.0.0.0/24.
10.  Keep **"VpcCidrBlock"** as 10.0.0.0/16.
11.  Click "Next".

### Step 3: Configure stack options

1.  Choose "Roll back all stack resources" and "Delete all newly created resources" under "Stack failure options".
2.  Click "Next".

### Step 4: Review

1.  Review and verify the details you've entered.
2.  ![Admin Email field in CloudFormation stack parameters](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-01.png)Provide the **"Admin Email"** for SSL generation.
3.  Tick **"I acknowledge that AWS CloudFormation might create IAM resources with custom names"**.
4.  Click **"Submit"**.

![Reviewing CloudFormation stack parameters for Superset](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-02.png)

Afterward, you'll be directed to the CloudFormation stacks page. Please wait for 5-10 minutes until the stack has been successfully created.

![Superset CloudFormation stack successfully created](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-03.png)

## Update DNS

### Step 1: Copy IP Address

Copy the public IP labeled **"PublicIp"** in the **"Outputs"** tab.

![Copying the PublicIp from CloudFormation Outputs tab](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-04.png)

### Step 2: Update DNS

1.  Go to AWS Route 53 and navigate to "Hosted Zones".
2.  Click **Create record**.
3.  Add a **record name** and paste the copied **PublicIp** into the **value** textbox.
4.  Click "Save".

![Creating a DNS record in AWS Route 53 for Superset](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-05.png)

## Access Superset

Access Superset using the **"DashboardUrl"** or **"DashboardUrlIp"** provided in the Outputs tab.

![Superset DashboardUrl in CloudFormation Outputs](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-06.png)

Note

If you receive a "502 Bad Gateway" error, wait approximately **5 minutes** and refresh the page. The application may still be initializing.

![Superset login page](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-07.png)

Please enter the **Username** and **Password** that you provided during stack creation. Store them securely for future reference.

## Generate SSL Manually

Superset will automatically try to set up SSL when a Route53-hosted domain is provided. If it fails, follow these steps to generate SSL manually.

### Step 1: Copy IP Address

1.  Follow the **Update DNS** steps above, if not already done.
2.  Copy the Public IP indicated as **"PublicIp"** in the **"Outputs"** tab.

![Copying the PublicIp from CloudFormation Outputs tab](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-08.png)

### Step 2: Log in to the server

1.  Open the terminal and go to the directory where your private key is located.
2.  Run: **ssh -i <your key name> ubuntu@<Public IP address>**
3.  Type "yes" and press Enter to confirm.

![Logging into Superset server via SSH](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-09.png)

### Step 3: Generate SSL

Run the following command and follow the prompts:

```plaintext
sudo /root/certificate_generate_standalone.sh
```

## Check Server Logs

### Step 1: Log in to the server

```plaintext
ssh -i <your key name> ubuntu@<Public IP address>
```

![Logging into Superset server via SSH](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-10.png)

### Step 2: Check the logs

```plaintext
sudo docker ps

sudo docker logs <container-id-prefix>
```

![Checking Docker container logs for Superset](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-11.png)

## Shutting Down Superset

1.  In CloudFormation, click the link labeled **"Instance"** in the **"Resources"** tab to open the EC2 instance.
2.  Stop the Superset instance from the **Instance state** dropdown. You can restart it later as needed.

![Navigating to the EC2 instance from CloudFormation](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-12.png) ![Stopping the Superset EC2 instance](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-13.png)

## Remove Superset

Delete the CloudFormation stack from the AWS Management Console under "CloudFormation Stacks" by clicking "Delete".

## Upgrades

When a new version is available in AWS Marketplace, remove the previous deployment after backing up necessary server data, and relaunch with the new version.

## Troubleshoot

1.  If you face vCPU quota limits, request an increase: [How to increase AWS quota](https://meetrix.io/blogs/increase-aws-vcpu-quota/).
![AWS vCPU quota limit error](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-14.png)3.  If you face _insufficient capacity_ errors while creating the stack, try another region or time.
![AWS insufficient capacity error](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-15.png)5.  If the dashboard is temporarily inaccessible, wait 5-10 minutes and retry.
![Superset dashboard temporarily inaccessible](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-16.png)

Check whether the instance storage is full.

-   Log into the server and run:

```plaintext
df -h
```

![Checking disk usage with df -h](https://meetrix.io/blog-images/paas-dev-guides/superset/superset-17.png)

-   If the root volume is between 90-100%, resize the EBS volume (per AWS docs), then reboot and restart the service.

## Conclusion

The Meetrix Superset Deployment Guide helps you integrate Superset into your AWS environment. Whether you're a DevOps engineer, data architect, or IT leader, this guide provides step-by-step instructions for a secure and scalable setup.

## Technical Support

Reach out to Meetrix Support ([aws@meetrix.io](mailto:aws@meetrix.io)) for assistance with Superset issues.

## Frequently Asked Questions

What is Apache Superset?

Apache Superset is an open-source business intelligence and data visualization platform. It allows you to create interactive dashboards, run complex analytics, and manage large-scale data visualizations across your organization.

What are the prerequisites for installing Superset on AWS?

You need basic knowledge of AWS services (EC2, CloudFormation), an active AWS account with appropriate permissions, and a sufficient vCPU limit to launch the required instance type.

Which instance type is recommended?

t3a.large is recommended as a baseline for running Apache Superset on AWS.

How do I handle upgrades?

When a new version is available in the AWS Marketplace, remove the previous deployment after backing up necessary server data, then relaunch with the new version.

How do I get technical support?

Reach out to Meetrix Support at [aws@meetrix.io](mailto:aws@meetrix.io) for assistance with Superset issues.

## Ready to Deploy Your Own Superset Instance?

Get started in minutes with our pre-configured AMI and take full control of your data visualization and analytics.

[Deploy Superset from AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-aeclrnbo27hxa)

Meetrix Store

Apache Superset

50+ charts and SSO, a Tableau alternative

[Deploy it](https://meetrix.io/store/superset/)

Meetrix Store New

Deploy what this guide covers, pre-configured.

-    [Apache Superset 50+ charts and SSO, a Tableau alternative](https://meetrix.io/store/superset/)
-    [Metabase Dashboards your team can build without SQL](https://meetrix.io/store/metabase/)
-    [Redash SQL dashboards with no per-seat licence](https://meetrix.io/store/redash/)
-    [Jitsi Meet Self-hosted video calls for 50 to 500 users](https://meetrix.io/store/jitsi-meet/)
-    [RustDesk Remote desktop AMI, a TeamViewer alternative](https://meetrix.io/store/rustdesk/)
-    [Coturn TURN/STUN for WebRTC, no per-minute relay fees](https://meetrix.io/store/coturn/)

[Browse all products](https://meetrix.io/store/)