It's recommended to upgrade your Redash instance once there are new releases, to benefit from new features and bug fixes. The upgrade process is relatively simple, and assuming you used one of the base images we provide, you can simply run the upgrade script. If you have a custom deployment, you can use the upgrade script as reference to create your own process.
In v1.0.0 we added the script to the repository, but if you have an earlier version, you will need to download the script first (note that you need to download it to your Redash server):
wget https://raw.githubusercontent.com/getredash/redash/master/bin/upgrade chmod +x upgrade
Before doing the upgrade, please make sure to do the following changes to your
You can upgrade to v1.0.0 and later only from v0.12.0, so if you have an older version, run: sudo upgrade --channel legacy first and then sudo upgrade.
Starting from v1.0.0, the upgrade script is part of the codebase, and running the script is as simple as:
cd /opt/redash/current sudo bin/upgrade
If you're using Docker to run Redash, don't use the upgrade script, but rather update the Docker image you're using.
You need to manually run the restart command:
sudo service supervisor restart
In v2.0.0 we fixed the upgrade script to use the correct command.
The upgrade process updates the code, applies migrations and upgrade Python requirements. But it does not upgrade Python requirements for the data sources (described in
In some cases, old packages will prevent the data source from loading. Make sure to manually update the requirements relevant to the data sources you need.
You need to upgrade the following Python packages:
sudo pip install -U google-api-python-client==1.5.1oauth2client==3.0.0)
Make sure to install PyAthena:
sudo pip install PyAthena>=1.0.0