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