Extended Support Release

What is an Extended Support Release?

During each monthly release, Mattermost backports high severity or high impact security fixes to the previous three monthly releases. Extended Support Releases (ESRs) are releases that will receive backports for security fixes and major bug fixes for the length of their life cycle.


Support for server Extended Support Release (ESR) 5.19 is coming to the end of its lifecycle on October 15th, 2020. Upgrading to server v5.25 or later is highly recommended.

What is the life cycle of an Extended Support Release?

Mattermost provides an ESR when a significant number of new features and improvements have been added to the product, and those new features have had sufficient time to stabilize. A new ESR is released twice a year every January and July release. An ESR is supported for 9 months to provide customers enough time to test and upgrade to the next ESR.

When an ESR is at the end of its life cycle, there will be announcements ahead of time to provide time for people to test, certify, and deploy a newer ESR version before support ends. There will be a clear upgrade path provided between ESR versions.

After a release reaches its end-of-life, no further updates will be provided for that version.

Please see Release Lifecycle documentation for full list of lifecycles for each Mattermost release.

To receive updates about Extended Support Releases, sign up for our mailing list here.


What is included in an Extended Support Release dot release?

Dot releases for ESR versions will contain high severity or high impact security fixes and bug fixes. They will not include changes to product functionality or new features.

Who should use an Extended Support Release?

ESRs are intended for organizations who value stability over having the newest features and improvements, or who have a long internal testing and certification process to undergo when upgrading.

If your organization prefers to have the newest features and improvements, Extended Support Releases may not be the best fit for you.

How do I install the Extended Support Release?

Follow our normal install or upgrade guides. Please follow the important upgrade notes for all the versions since the current ESR version you have currently installed. Please also see the changelog for list of database, API and config.json updates for each release.

When downloading the Mattermost version, choose an Extended Support Release from the list below.

What are the current supported Extended Support Release versions?

Version Type Release Date End of Support Latest Dot Release Download link Upgrade Notes
5.25 Quality July 16, 2020 April 15, 2021 5.25.5 SAML Setting “Use Improved SAML Library (Beta)” was disabled. Please use xmlsec1.
5.19 Quality January 16, 2020 October 15, 2020 5.19.3  
5.9 Quality April 16, 2019 April 15, 2020 5.9.8 Please upgrade to 5.0 prior to upgrading to 5.9
4.10 Quality May 16, 2018 July 15, 2019 4.10.10  

How do I restore a previous Extended Support Release?

Before you perform an upgrade, please ensure you have done a full back up of your current version. You can restore the database and previous version if you need to revert an upgrade. Please note that previous ESR versions are subject to an end of support date.

Why is an Extended Support Release supported for 9 months and not longer?

We chose 9 months because the overhead for maintaining an ESR is high (and becomes higher the longer the support window is). If we increase the support window, it decreases how much we can develop the product. We specifically chose “ESR” instead of “LTS”, since it is not intended to be a multi-year long term support release. The 9 months support timeframe will not be extended in any case.

Can customers pay for extended support?

At this point, we are not planning on letting customers pay for extended support, but we are open to discuss options for this. Please speak to your Customer Success Manager if you have additional requirements for extended support.

How do we notify customers about new and deprecated Extended Support Releases?

For a new upcoming ESR, we send out an email announcement 2 months in advance. We also add a reminder on our release announcement, changelog and via a Forum post (see example).

For a deprecated ESR, we send out an email announcement 3 months in advance. We also add reminders on our release announcements, changelogs, important upgrade notes, and our Forum site.

To receive updates about Extended Support Releases, sign up for our mailing list here.