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
  

• 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 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).

  $ 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/
  

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