generalmattermost

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