Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
41 commits
Select commit Hold shift + click to select a range
2fb1344
Update docs for v11.10 feature release
github-actions[bot] Jul 17, 2026
a11c4e7
Update important-upgrade-notes.rst
amyblais Jul 17, 2026
3500705
Add v11.10 User Interface entries to UI & ADA changelog
amyblais Jul 22, 2026
a260f2c
Update ui-ada-changelog.rst
amyblais Jul 22, 2026
dba1d4b
Update important-upgrade-notes.rst
amyblais Jul 22, 2026
30e9ac2
Update open-source-components.rst
amyblais Jul 22, 2026
d43b153
Update mattermost-desktop-releases.md
amyblais Jul 22, 2026
ec37e58
Update software-hardware-requirements.rst
amyblais Jul 22, 2026
eaef379
Update release-policy.md
amyblais Jul 22, 2026
8eb139c
Update source/product-overview/ui-ada-changelog.rst
amyblais Jul 22, 2026
0a6c0a4
Update software-hardware-requirements.rst
amyblais Jul 22, 2026
45895c1
Update software-hardware-requirements.rst
amyblais Jul 22, 2026
21cec60
Update ui-ada-changelog.rst
amyblais Jul 22, 2026
348e969
Update ESR support snippet to reflect v10.11 ESR has reached end of life
amyblais Jul 22, 2026
f741f80
Update ESR support snippet to reflect v10.11 ESR has reached end of life
amyblais Jul 22, 2026
f1f7fe6
Update ESR support snippet to reflect v10.11 ESR has reached end of life
amyblais Jul 22, 2026
f7934fb
Update ESR support note to reflect v10.11 ESR has reached end of life
amyblais Jul 22, 2026
ac4a430
Update ESR lifecycle content to reflect v10.11 ESR has reached end of…
amyblais Jul 22, 2026
7cb053b
Fix corrupted null-escape sequences in troubleshooting section
amyblais Jul 22, 2026
b7a7ed8
Update release-policy.md
amyblais Jul 22, 2026
5049eb4
Move v10 changelog into unsupported legacy releases
claude Jul 22, 2026
73ed982
Revert "Move v10 changelog into unsupported legacy releases"
claude Jul 22, 2026
eddec67
Update release-policy.md
amyblais Jul 22, 2026
5fb33c8
Update release-policy.md
amyblais Jul 22, 2026
cb7f874
Update ui-ada-changelog.rst
amyblais Jul 22, 2026
4af8dee
Update software-hardware-requirements.rst
amyblais Jul 22, 2026
b81ee70
Update mattermost-server-releases.md
amyblais Jul 23, 2026
7601918
Update release-policy.md
amyblais Jul 23, 2026
627631f
Update release-policy.md
amyblais Jul 23, 2026
fa064b1
Update prepare-to-upgrade-mattermost.rst
amyblais Jul 23, 2026
517fc52
Update common-esr-support-rst.rst
amyblais Jul 23, 2026
f381a76
Update common-esr-support-upgrade.md
amyblais Jul 23, 2026
a497bb7
Update common-esr-support.md
amyblais Jul 23, 2026
ae69882
Update mattermost-desktop-releases.md
amyblais Jul 27, 2026
33f8992
Revert ESR end-of-life wording change on 4 pages
claude Jul 29, 2026
153351c
Update mattermost-desktop-releases.md
amyblais Jul 29, 2026
94b931c
Update mattermost-server-releases.md
amyblais Jul 29, 2026
07b62fc
Revert mattermost-desktop-releases.md changes
claude Jul 29, 2026
eec15e7
Update release-policy.md
amyblais Jul 29, 2026
d242270
Update release-policy.md
amyblais Jul 29, 2026
1e1c039
Update release-policy.md
amyblais Jul 29, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions source/administration-guide/upgrade/important-upgrade-notes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,37 @@ We recommend reviewing the `additional upgrade notes <#additional-upgrade-notes>
| If you're upgrading | Then... |
| from a version earlier than... | |
+====================================================+==================================================================================================================================================================+
| v11.10 | This migration adds a new composite index, ``idx_propertyvalues_groupid_updateat_id``, on the ``PropertyValues`` table covering the columns ``GroupID``, |
| | ``UpdateAt``, and ``ID``. The ``PropertyValues`` table is part of the Properties/Custom Attributes feature introduced in recent Mattermost versions. This index |
| | improves query performance for lookups and range scans that filter or sort by ``GroupID`` and ``UpdateAt``, which are common access patterns for this feature. |
| | The index is created using ``CONCURRENTLY``, so the build process does not block concurrent reads or writes against the ``PropertyValues`` table. The migrations |
| | are fully backwards-compatible and no database downtime is expected for this upgrade. The SQL queries included are: |
| | |
| | .. code-block:: sql |
| | |
| | -- morph:nontransactional |
| | CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_propertyvalues_groupid_updateat_id |
| | ON PropertyValues(GroupID, UpdateAt, ID); |
| | |
| | .. code-block:: sql |
| | |
| | -- morph:nontransactional |
| | DROP INDEX CONCURRENTLY IF EXISTS idx_propertyvalues_groupid_updateat_id; |
| +------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| | This migration adds a new nullable ``lastnotifiedat`` column (``bigint``) to the ``useraccesstokens`` table. The column is intended to track the last time a |
| | notification was sent for a given user access token, enabling improved token-related notification logic. Because the column is nullable with no default value, |
| | PostgreSQL performs a catalog-only operation — no table rewrite occurs — and the lock is held for only a few milliseconds. Previous versions of Mattermost will |
| | simply ignore the new column, ensuring seamless compatibility across a rolling upgrade. The migrations are fully backwards-compatible and no database downtime |
| | is expected for this upgrade. The SQL queries included are: |
| | |
| | .. code-block:: sql |
| | |
| | -- Up migration |
| | ALTER TABLE useraccesstokens ADD COLUMN IF NOT EXISTS lastnotifiedat bigint; |
| | |
| | -- Down migration |
| | ALTER TABLE useraccesstokens DROP COLUMN IF EXISTS lastnotifiedat; |
+----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Comment thread
amyblais marked this conversation as resolved.
| v11.9 | Mattermost v11.9 changes how redirect URI allowlist patterns are matched for OAuth Dynamic Client Registration (DCR). Patterns are now evaluated per URL |
| | component (scheme, host, path, and query) rather than as a whole-string glob. As a result, a pattern such as ``https://*.example.com/**`` no longer matches |
| | redirect URIs that include a query string (for example, ``https://app.example.com/callback?tenant=foo``); redirect URIs without a query string continue to |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ The following open source components are used to provide the full benefits of Ma
Desktop
--------

- Mattermost Desktop v6.3.0 - `View Open Source Components <https://github.com/mattermost/desktop/blob/release-6.3/NOTICE.txt>`__.
- Mattermost Desktop v6.2.0 - `View Open Source Components <https://github.com/mattermost/desktop/blob/release-6.2/NOTICE.txt>`__.
- Mattermost Desktop v6.1.0 - `View Open Source Components <https://github.com/mattermost/desktop/blob/release-6.1/NOTICE.txt>`__.
- Mattermost Desktop v6.0.0 - `View Open Source Components <https://github.com/mattermost/desktop/blob/release-6.0/NOTICE.txt>`__.
Expand Down Expand Up @@ -39,6 +40,7 @@ Desktop
Mobile
-------

- Mattermost Mobile v2.43.0 - `View Open Source Components <https://github.com/mattermost/mattermost-mobile/blob/release-2.43/NOTICE.txt>`__.
- Mattermost Mobile v2.42.0 - `View Open Source Components <https://github.com/mattermost/mattermost-mobile/blob/release-2.42/NOTICE.txt>`__.
- Mattermost Mobile v2.41.0 - `View Open Source Components <https://github.com/mattermost/mattermost-mobile/blob/release-2.41/NOTICE.txt>`__.
- Mattermost Mobile v2.40.0 - `View Open Source Components <https://github.com/mattermost/mattermost-mobile/blob/release-2.40/NOTICE.txt>`__.
Expand Down Expand Up @@ -142,6 +144,7 @@ Mobile
Server
------------------------------

- Mattermost Enterprise Edition v11.10.0 - `View Open Source Components <https://github.com/mattermost/mattermost-server/blob/release-11.10/NOTICE.txt>`__.
- Mattermost Enterprise Edition v11.9.0 - `View Open Source Components <https://github.com/mattermost/mattermost-server/blob/release-11.9/NOTICE.txt>`__.
- Mattermost Enterprise Edition v11.8.0 - `View Open Source Components <https://github.com/mattermost/mattermost-server/blob/release-11.8/NOTICE.txt>`__.
- Mattermost Enterprise Edition v11.7.0 - `View Open Source Components <https://github.com/mattermost/mattermost-server/blob/release-11.7/NOTICE.txt>`__.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -100,17 +100,17 @@ Ensure you review the :doc:`important-upgrade-notes` for all intermediate releas
ALTER TABLE users ALTER COLUMN notifyprops TYPE jsonb USING notifyprops::jsonb;
ALTER TABLE users ALTER COLUMN timezone TYPE jsonb USING timezone::jsonb;

Once you've identified the table being affected, verify how many invalid occurrences of `\u0000` you have using the following SELECT query:
Once you've identified the table being affected, verify how many invalid occurrences of `\\u0000` you have using the following SELECT query:

.. code-block:: sh

SELECT COUNT(*) FROM TableName WHERE ColumnName LIKE '%\u0000%';
SELECT COUNT(*) FROM TableName WHERE ColumnName LIKE '%\\u0000%';

Then select and fix the rows accordingly. If you prefer, you can also fix all occurrences at once in a given table or column using the following UPDATE query:

.. code-block:: sh

UPDATE TableName SET ColumnName = regexp_replace(ColumnName, '\\u0000', '', 'g') WHERE ColumnName LIKE '%\u0000%';
UPDATE TableName SET ColumnName = regexp_replace(ColumnName, '\\u0000', '', 'g') WHERE ColumnName LIKE '%\\u0000%';

Upgrade high availability cluster-based deployments
---------------------------------------------------
Expand Down
2 changes: 1 addition & 1 deletion source/deployment-guide/server/linux/deploy-rhel.rst
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ In a terminal window, ssh onto the system that will host the Mattermost Server.

.. code-block:: sh
wget https://releases.mattermost.com/11.9.0/mattermost-11.9.0-linux-amd64.tar.gz
wget https://releases.mattermost.com/11.10.0/mattermost-11.10.0-linux-amd64.tar.gz
.. tab:: Current ESR

Expand Down
2 changes: 1 addition & 1 deletion source/deployment-guide/server/linux/deploy-tar.rst
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ In a terminal window, ssh onto the system that will host the Mattermost Server.

.. code-block:: sh
wget https://releases.mattermost.com/11.9.0/mattermost-11.9.0-linux-amd64.tar.gz
wget https://releases.mattermost.com/11.10.0/mattermost-11.10.0-linux-amd64.tar.gz
.. tab:: Current ESR

Expand Down
14 changes: 7 additions & 7 deletions source/deployment-guide/software-hardware-requirements.rst
Original file line number Diff line number Diff line change
Expand Up @@ -50,10 +50,10 @@ PC web
.. csv-table::
:header: "Browser", "Self-Hosted Technical Requirement", "Cloud Technical Requirement"

"Chrome", "v146+", "v146+"
"Chrome", "v150+", "v150+"
"Firefox", "v140+", "v140+"
"Safari", "v26.2+", "v26.2+"
"Edge", "v146+", "v146+"
"Edge", "v150+", "v150+"

`*` Internet Explorer (IE11) is no longer supported. We recommend using the `Mattermost desktop app <https://mattermost.com/apps/>`_ or another supported browser. See `this forum post <https://forum.mattermost.com/t/mattermost-is-dropping-support-for-internet-explorer-ie11-in-v5-16/7575>`__ to learn more.

Expand All @@ -78,8 +78,8 @@ Mobile web
.. csv-table::
:header: "Browser", "Technical Requirement"

"iOS", "iOS 16.0+ with Safari 26.2+ or Chrome 146+"
"Android", "Android 7+ with Chrome 146+"
"iOS", "iOS 16.0+ with Safari 26.2+ or Chrome 150+"
"Android", "Android 7+ with Chrome 150+"

Email client
^^^^^^^^^^^^
Expand Down Expand Up @@ -131,11 +131,11 @@ When a PostgreSQL version reaches its end of life (EOL), Mattermost will require
+------------------------------------------------------------+------------------+--------------------------------+
| **Mattermost Version** | **Release Date** | **Minimum PostgreSQL Version** |
+============================================================+==================+================================+
| :ref:`v9.11 ESR <release-v9-11-extended-support-release>` | 2024-8-15 | 11.x |
| :ref:`v9.11 ESR <release-v9-11-extended-support-release>` | 2024-8-16 | 11.x |
+------------------------------------------------------------+------------------+--------------------------------+
| :ref:`v10.5 ESR <release-v10.5-extended-support-release>` | 2025-2-15 | 11.x |
| :ref:`v10.5 ESR <release-v10.5-extended-support-release>` | 2025-2-16 | 11.x |
+------------------------------------------------------------+------------------+--------------------------------+
| :ref:`v10.6 <release-v10.6-feature-release>` | 2025-3-15 | 13.x |
| :ref:`v10.6 <release-v10.6-feature-release>` | 2025-3-16 | 13.x |
+------------------------------------------------------------+------------------+--------------------------------+
| :ref:`v10.11 ESR <release-v10.11-extended-support-release>`| 2025-8-15 | 13.x |
+------------------------------------------------------------+------------------+--------------------------------+
Expand Down
1 change: 1 addition & 0 deletions source/product-overview/mattermost-server-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ Mattermost releases a new server version on the 16th of each month in [binary fo

| **Release** | **Released on** | **Support ends** |
|:---|:---|:---|
| v11.10 [Download](https://releases.mattermost.com/11.10.0/mattermost-11.10.0-linux-amd64.tar.gz) \| {ref}`Changelog <release-v11.10-feature-release>` \| <details class="mm-sbom"><summary>SBOM</summary><ul><li><a href="https://github.com/mattermost/mattermost/releases/download/v11.10.0/sbom-mattermost-v11.10.0.json">Team Edition</a></li><li><a href="https://releases.mattermost.com/11.10.0/sbom-enterprise-v11.10.0.json">Enterprise</a></li></ul></details> | 2026-08-14 | 2026-11-15 |
Comment thread
amyblais marked this conversation as resolved.
Comment thread
amyblais marked this conversation as resolved.
Comment thread
amyblais marked this conversation as resolved.
| v11.9 [Download](https://releases.mattermost.com/11.9.0/mattermost-11.9.0-linux-amd64.tar.gz) \| {ref}`Changelog <release-v11.9-feature-release>` \| <details class="mm-sbom"><summary>SBOM</summary><ul><li><a href="https://github.com/mattermost/mattermost/releases/download/v11.9.0/sbom-mattermost-v11.9.0.json">Team Edition</a></li><li><a href="https://releases.mattermost.com/11.9.0/sbom-enterprise-v11.9.0.json">Enterprise</a></li></ul></details> | 2026-07-16 | 2026-10-15 |
| v11.8 [Download](https://releases.mattermost.com/11.8.4/mattermost-11.8.4-linux-amd64.tar.gz) \| {ref}`Changelog <release-v11.8-feature-release>` \| <details class="mm-sbom"><summary>SBOM</summary><ul><li><a href="https://github.com/mattermost/mattermost/releases/download/v11.8.4/sbom-mattermost-v11.8.4.json">Team Edition</a></li><li><a href="https://releases.mattermost.com/11.8.4/sbom-enterprise-v11.8.4.json">Enterprise</a></li></ul></details> | 2026-06-16 | 2026-09-15 |
| v11.7 [Download](https://releases.mattermost.com/11.7.7/mattermost-11.7.7-linux-amd64.tar.gz) \| {ref}`Changelog <release-v11.7-extended-support-release>` \| <details class="mm-sbom"><summary>SBOM</summary><ul><li><a href="https://github.com/mattermost/mattermost/releases/download/v11.7.7/sbom-mattermost-v11.7.7.json">Team Edition</a></li><li><a href="https://releases.mattermost.com/11.7.7/sbom-enterprise-v11.7.7.json">Enterprise</a></li></ul></details> | 2026-05-15 | 2027-05-15 {ref}`EXTENDED <release-types>` |
Expand Down
10 changes: 5 additions & 5 deletions source/product-overview/release-policy.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,9 @@ See the full list of all Mattermost Server and desktop app releases and life cyc

Mattermost Extended Support Releases (ESRs) are a strategic choice for organizations looking for stability and reduced frequency of updates. Using ESRs can minimize disruptions associated with frequent upgrades, making them an attractive option for environments where stability is paramount.

Starting with the August 2025 Mattermost server and desktop app releases (server v10.11 and desktop app v5.13), Mattermost has adjusted the ESR life cycle as follows:
- **Extended Cadence**: ESRs are released every 9 months.
- **Prolonged Support**: ESRs are supported for 12 months.
The ESR lifecycle for Mattermost server and desktop app Extended Support Releases is as follows:
- **Cadence**: ESRs are released every 9 months.
- **Support**: ESRs are supported for 12 months.

We strongly recommend planning ahead for upgrades before the end of an ESR's life cycle to ensure continuity in receiving security updates.

Expand All @@ -48,7 +48,6 @@ gantt
axisFormat %b %y

section Releases
v10.10 :done, 2025-07-16, 2025-10-15
v10.11 & Desktop App v5.13 Extended Support :crit, 2025-08-16, 2026-08-15
v10.12 :done, 2025-09-16, 2025-12-15
v11.0 :done, 2025-10-16, 2026-01-15
Expand All @@ -61,7 +60,8 @@ gantt
v11.7 & Desktop App v6.2 Extended Support :crit, 2026-05-15, 2027-05-15
v11.8 :active, 2026-06-16, 2026-09-15
v11.9 :active, 2026-07-16, 2026-10-15
v11.10 :active, 2026-08-16, 2026-11-15
v11.10 :active, 2026-08-14, 2026-11-15
Comment thread
amyblais marked this conversation as resolved.
v11.11 :active, 2026-09-16, 2026-12-15
```

**Timeline Legend:**
Expand Down
Loading
Loading