Upgrade Re:dash

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

NOTE: The Approach A sections referred to below do not apply to Bitnami native installers. Users of Bitnami native installers should refer only to the Approach B sections.

NOTE: It is strongly recommended to create a backup before starting the update process. If you have important data, create and restore a backup to ensure that everything works properly.

You can upgrade the Bitnami Re:dash Stack following the steps below.

  • Download the latest release tarball from GitHub.

  • Navigate to the Redash installation directory. Depending on your installation type, execute the following commands:

    • Approach A (Bitnami installations using system packages):

        $ cd installdir/redash
    • Approach B (Self-contained Bitnami installations):

        $ cd installdir/apps/redash/htdocs/
  • Create a backup of your current version:

      $ mkdir /tmp/redash-backup
      $ sudo mv * /tmp/redash-backup
  • Create the htdocs directory for the new version and unpack it there:

      $ sudo tar -xvf /path/to/new/tarball
  • Copy your .env file and your venv/ directory from the current version to the new version:

      $ cp -p /tmp/redash-backup/.env .
      $ cp -rp /tmp/redash-backup/venv .
  • Check if you have any new migrations in the new version. Check it by running this command:

      $ diff migrations /tmp/redash-backup/migrations
  • Apply new migrations (if it is necessary):

      $ . venv/bin/activate
      $ ./bin/run python migrations/
  • Install any new requirements:

      $ . venv/bin/activate
      $ pip install -r requirements.txt
  • Restart servers:

      $ sudo installdir/ restart
Last modification July 14, 2021