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/
  • 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 April 8, 2020