Important Upgrade Notes

Important

Support for Mattermost Server v10.5 Extended Support Release is coming to the end of its life cycle on November 15, 2025. Upgrading to Mattermost Server v10.11 or later is recommended.

We recommend reviewing the additional upgrade notes at the bottom of this page.

Additional upgrade notes

Note

  • Upgrading the Microsoft Teams Calling plugin to v2.0.0 requires users to reconnect their accounts.

  • Mattermost plugins built with Go versions 1.22.0 and 1.22.1 do not work. Plugin developers should use Go 1.22.2 or newer instead.

  • Keybase has stopped serving Mattermost’s Ubuntu repository signing key. If you were using it, update your installation scripts to retrieve the key as mentioned in our Linux deployment documentation.

  • We recommend avoiding the use of MySQL 8.0.22 as it contains an issue with JSON column types changing string values to integers which is preventing Mattermost from working properly.

  • When upgrading to Mattermost 7.x from a 5.x release, upgrade to 5.37.10 first before attempting the v7.x upgrade.

  • SQL queries for related schema changes below are automatically executed during the Mattermost server upgrade process. You don’t need to run these queries manually. These SQL queries are provided to help you understand what database changes will occur during the upgrade, and for cases where you prefer to reduce downtime by pre-applying schema changes.

  • Mattermost v11 release with several planned deprecations is scheduled for October 16th. See the Removed and Deprecated Features document for more details.