Upgrade Mattermost Team Edition

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.

Follow these steps to upgrade Mattermost:

  • Stop the server:

      $ sudo /opt/bitnami/ctlscript.sh stop mattermost
  • Navigate to the Mattermost installation directory:

      $ cd /opt/bitnami/mattermost
  • Back up the current configuration files:

      $ mkdir ~/backup
      $ cp config/config.json ~/backup/
  • Back up the database as described on the MySQL page.

  • Back up the Mattermost data files:

      $ cp -r data ~/backup/
  • Download the latest version of Mattermost:

      $ cd ..
      $ wget https://releases.mattermost.com/X.X.X/mattermost-team-X.X.X-linux-amd64.tar.gz
  • Remove previous Mattermost files (already backed up in previous steps).

      $ rm -rf mattermost/*
  • Uncompress the new version:

      $ tar xzf mattermost-team-X.X.X-linux-amd64.tar.gz -C mattermost --strip-components=1
  • Restore the previous configuration file:

      $ cd -
      $ cp ~/backup/config.json config/config.json
  • Adjust file permissions as below:

      $ chown -R bitnami:mattermost .
      $ sudo chown -R mattermost:mattermost logs client data
  • Restart the server:

      $ sudo /opt/bitnami/ctlscript.sh restart mattermost
  • Open the “System Console” and save a change. Doing this will upgrade your config.json schema to the latest version using default values for any new settings added.

Last modification February 9, 2023