Mattermost Platform

Support for ESR 5.25 is ending

Upgrade to ESR 5.31 for improved security and performance, mobile app compatibility, and enhanced user experience

As of April 15, 2021, Mattermost Extended Support Release (ESR) version 5.25 will no longer be supported. If any of your servers are not on ESR 5.31 or later, upgrading is highly recommended. With our simple upgrade steps, it takes only a few minutes.

Extended Support Releases are releases that will receive backports for high severity or high impact security fixes for the length of their lifecycle. Mattermost provides an ESR when a significant number of new features and improvements have been added to the product and when those new features have had sufficient time to stabilize. 

ESRs benefit organizations that value stability over having the newest features and improvements or those that have a long internal testing and certification process to undergo when upgrading. Mattermost designates two releases every year as ESRs, one in January and one in July. We support each ESR version for nine months to provide you with enough time to upgrade to the next ESR. 

ESR v5.31 is supported until October 15, 2021.

Mattermost Extended Support Release schedule

Why should I upgrade my server version?

1. Security

See a full list of security updates.

2. Mobile app compatibility 

As we innovate and offer newer versions of our mobile apps, we maintain backwards compatibility only with supported server versions. Users who upgrade to the newest mobile apps while being connected to an unsupported server version can be exposed to compatibility issues, which can cause crashes or severe bugs that break core functionality of the app.

3. New features and improved user experience

We add new features and user experience enhancements to our new versions every month. See our changelog for a full list of the latest features, performance enhancements, bug fixes, and other improvements.

How do I upgrade my server?

Follow these basic steps to upgrade your server quickly and easily:

Step 1: Review the Important Upgrade Notes to make sure you are aware of any actions you need to take before or after upgrading from your particular version.

Step 2: If you’re upgrading from a version prior to v5.0, modify your service file to work with the binary changes introduced with 5.0. Your execution directory should point to the Mattermost base directory (e.g., /opt/mattermost) and your binary should point to the Mattermost binary (e.g., /opt/mattermost/bin/mattermost).

Step 3: See the upgrade guide for step-by-step instructions on how to upgrade your server, including downloading the latest server version and backing up your data and application.

If you need any assistance, contact our support team.

Future Extended Support Releases

To receive an update on future ESRs, sign up for our mailing list here

Questions or concerns?

Contact us.


Amy Blais is the Release Manager at Mattermost, Inc. Her other roles include Community and Customer Support. She previously served as the company’s Associate Marketing Manager.