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/ stop mattermost
  • Back up the current configuration files:

      $ sudo mkdir /opt/bitnami/apps/mattermost/backup/
      $ sudo cp /opt/bitnami/apps/mattermost/server/config/config.json /opt/bitnami/apps/mattermost/backup/
  • Back up the database as described on the MySQL page.

  • Download the latest version of Mattermost:

      $ cd /opt/bitnami/apps/mattermost/
      $ sudo wget
  • Remove previous Mattermost files (already backed up in previous steps).

      $ sudo rm -rf /opt/bitnami/apps/mattermost/server/*
  • Uncompress the new version:

      $ sudo tar xzf mattermost-team-X.X.X-linux-amd64.tar.gz -C /opt/bitnami/apps/mattermost/server --strip-components=1
  • Restore the previous configuration file:

      $ sudo cp /opt/bitnami/apps/mattermost/backup/config.json /opt/bitnami/apps/mattermost/server/config/config.json
  • Adjust file permissions:

      $ sudo chown -R root:root /opt/bitnami/apps/mattermost/server
      $ sudo touch /opt/bitnami/apps/mattermost/server/logs/mattermost.log
      $ sudo chown -R bitnami:mattermost /opt/bitnami/apps/mattermost/server/logs
      $ sudo chmod g+w /opt/bitnami/apps/mattermost/server/logs/mattermost.log
      $ sudo chown -R bitnami:mattermost /opt/bitnami/apps/mattermost/server/client/
      $ sudo chmod -R g+w /opt/bitnami/apps/mattermost/server/client/
      $ sudo chown -R root:mattermost /opt/bitnami/apps/mattermost/server/config
      $ sudo chmod g+w /opt/bitnami/apps/mattermost/server/config/config.json
  • Restart the server:

      $ sudo /opt/bitnami/ 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 June 16, 2021