Skip to main content
Version: Next

Upgrading Superset

Docker Compose​

First, make sure to shut down the running containers in Docker Compose:

docker compose down

Next, update the folder that mirrors the superset repo through git:

git pull origin master

Then, restart the containers and any changed Docker images will be automatically pulled down:

docker compose up

Updating Superset Manually​

To upgrade superset in a native installation, run the following commands:

pip install apache_superset --upgrade

Upgrading the Metadata Database​

Migrate the metadata database by running:

superset db upgrade
superset init

While upgrading superset should not delete your charts and dashboards, we recommend following best practices and to backup your metadata database before upgrading. Before upgrading production, we recommend upgrading in a staging environment and upgrading production finally during off-peak usage.

Breaking Changes​

For a detailed list of breaking changes and migration notes for each version, see UPDATING.md.

This file documents backwards-incompatible changes and provides guidance for migrating between major versions, including:

  • Configuration changes
  • API changes
  • Database migrations
  • Deprecated features