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: 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.

  • Create a backup of your current version:

      $ mv installdir/apps/redash/htdocs installdir/apps/redash/htdocs.bak
  • Create the htdocs directory for the new version and unpack it there:

      $ mkdir installdir/apps/redash/htdocs
      $ tar -C installdir/apps/redash/htdocs -xvf /path/to/new/tarball
  • Copy your .env file and your venv/ directory from the current version to the new version:

      $ cp installdir/apps/redash/htdocs.bak/.env installdir/apps/redash/htdocs
      $ cp -R installdir/apps/redash/htdocs.bak/venv installdir/apps/redash/htdocs
  • Check if you have any new migrations in the new version. Check it by running this command:

      $ diff installdir/apps/redash/htdocs/migrations installdir/apps/redash/htdocs.bak/migrations
  • Apply new migrations (if it is necessary):

      $ cd installdir/apps/redash/htdocs
      $ . venv/bin/activate
      $ ./bin/run python migrations/
  • Install any new requirements:

      $ cd installdir/apps/redash/htdocs
      $ . venv/bin/activate
      $ pip install -r requirements.txt
  • Restart servers:

      $ installdir/ restart
Last modification April 8, 2020