Skip to content

v11.8 Upgrade Notes #8983

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
amyblais wants to merge 7 commits into
base: v11.8-documentation
Choose a base branch
from
Open

v11.8 Upgrade Notes #8983

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
1e7d3cf
Update docs for v11.8 (June 16th) release
github-actions[bot] May 18, 2026
0e8b89c
Update mattermost-desktop-releases.md
amyblais May 18, 2026
2c676f0
Update open-source-components.rst
amyblais May 18, 2026
b170b72
Update ui-ada-changelog.rst
amyblais May 20, 2026
c2ae1fc
Update important-upgrade-notes.rst
amyblais May 20, 2026
9e087e7
Update important-upgrade-notes.rst
amyblais May 20, 2026
c14bb0d
Merge branch 'v11.8-documentation' into claude/issue-8981-20260518-1022
amyblais May 21, 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
58 changes: 58 additions & 0 deletions source/administration-guide/upgrade/important-upgrade-notes.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,64 @@ We recommend reviewing the `additional upgrade notes <#additional-upgrade-notes>
| If you're upgrading | Then... |
| from a version earlier than... | |
+====================================================+==================================================================================================================================================================+
| v11.8 | Added a new ``Version`` column to the ``PropertyGroups`` table to distinguish PSAv1 (legacy) groups from PSAv2 groups. Existing groups default to version 1, |
| | preserving current behavior for all legacy callers. ``PropertyGroups`` is a small configuration-like table, and the ``ADD COLUMN ... DEFAULT 1 NOT NULL`` is a |
| | metadata-only operation in PostgreSQL — no table rewrite occurs and the ``AccessExclusiveLock`` on ``PropertyGroups`` is held only for milliseconds. The |
| | migrations are fully backwards-compatible and no database downtime is expected for this upgrade. The SQL queries included are: |
| | |
| | .. code-block:: sql |
| | |
| | -- Pre-upgrade schema changes (Mattermost 11.8). |
| | |
| | ALTER TABLE PropertyGroups ADD COLUMN IF NOT EXISTS Version integer DEFAULT 1 NOT NULL; |
| +------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| | Raised the PostgreSQL planner statistics target for ``posts.rootid`` and ``posts.channelid`` from the default 100 to 5000, and refreshes planner statistics |
| | with ``ANALYZE posts (rootid, channelid)``. The ``ALTER COLUMN ... SET STATISTICS`` statements are metadata-only operations that acquire only a |
| | ``SHARE UPDATE EXCLUSIVE`` lock — no table rewrite occurs and concurrent SELECT, INSERT, UPDATE, and DELETE on ``posts`` remain unblocked. The ``ANALYZE`` step |
| | may take several minutes on large ``posts`` tables (100M+ rows) due to the larger sample size, but does not block reads or writes. The migrations are fully |
| | backwards-compatible and no database downtime is expected for this upgrade. The SQL queries included are: |
| | |
| | .. code-block:: sql |
| | |
| | ALTER TABLE posts ALTER COLUMN rootid SET STATISTICS 5000; |
| | ALTER TABLE posts ALTER COLUMN channelid SET STATISTICS 5000; |
| | ANALYZE posts (rootid, channelid); |
| +------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| | Extended the ``channel_type`` enum with two new values: ``'BO'`` and ``'BP'``. The ``ALTER TYPE ... ADD VALUE`` statements acquire a brief |
| | ``AccessExclusiveLock`` on the ``channel_type`` type only — no table rewrite occurs and no row-level locking is applied to the ``channels`` table, making the |
| | operation near-instant. The migrations are fully backwards-compatible and no database downtime is expected for this upgrade. The SQL queries included are: |
| | |
| | .. code-block:: sql |
| | |
| | ALTER TYPE channel_type ADD VALUE IF NOT EXISTS 'BO'; |
| | ALTER TYPE channel_type ADD VALUE IF NOT EXISTS 'BP'; |
| +------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| | Introduced four schema migrations to the property and attribute system (``PropertyFields``, ``PropertyGroups``, ``AttributeView``) as part of the same release |
| | cycle. Migrations 000168 and 000169 add a nullable ``LinkedFieldID varchar(26)`` column to ``PropertyFields`` and a partial concurrent index over it, enabling |
| | fields to reference another field as a link. Migrations 000176 and 000177 promote the existing Custom Profile Attributes property group to a more general |
| | ``access_control`` group by updating permission columns on ``PropertyFields`` rows, renaming the ``PropertyGroups`` entry from ``custom_profile_attributes`` to |
| | ``access_control``, and narrowing the ``AttributeView`` materialized view to user-scoped attributes only. **Migrations 000176 and 000177 must ship together.** |
| | None of the affected tables are in the large-table list — the property system tables are small. Note: during the rolling-upgrade window, old-ESR nodes |
| | hard-coding ``'custom_profile_attributes'`` as the group lookup key will experience transient failures on CPA profile read/write endpoints and the ABAC |
| | policy-management admin UI; end-user channel access and the membership sync worker are unaffected. The migrations are fully backwards-compatible and no database |
| | downtime is expected for this upgrade. The SQL queries included are: |
| | |
| | .. code-block:: sql |
| | |
| | -- 000168: Add LinkedFieldID column |
| | ALTER TABLE PropertyFields ADD COLUMN IF NOT EXISTS LinkedFieldID varchar(26); |
| | |
| | -- 000169: Create partial index on LinkedFieldID |
| | CREATE INDEX CONCURRENTLY idx_propertyfields_linkedfieldid ON PropertyFields(LinkedFieldID) WHERE LinkedFieldID IS NOT NULL AND DeleteAt = 0; |
| | |
| | -- 000176: Migrate CPA to access_control |
| | UPDATE PropertyFields SET ObjectType = 'user' WHERE GroupID = (SELECT Id FROM PropertyGroups WHERE Name = 'custom_profile_attributes'); |
| | UPDATE PropertyGroups SET Name = 'access_control', Version = 2 WHERE Name = 'custom_profile_attributes'; |
| | |
| | -- 000177: Refresh AttributeView with user-scoped filter |
| | DROP MATERIALIZED VIEW AttributeView; |
| | CREATE MATERIALIZED VIEW AttributeView ... WHERE pf.ObjectType = 'user'; |
+----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| v11.7 | FIPS builds require a minimum of 14 characters for passwords, atmos/camo proxy configuration, and shared channel secrets. Shorter passwords for existing users |
| | will no longer be valid and require a password reset. Non-FIPS builds are unaffected. |
| +------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Expand Down
2 changes: 2 additions & 0 deletions source/administration-guide/upgrade/open-source-components.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ Desktop
Mobile
-------

- 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>`__.
- Mattermost Mobile v2.39.0 - `View Open Source Components <https://github.com/mattermost/mattermost-mobile/blob/release-2.39/NOTICE.txt>`__.
- Mattermost Mobile v2.38.0 - `View Open Source Components <https://github.com/mattermost/mattermost-mobile/blob/release-2.38/NOTICE.txt>`__.
Expand Down Expand Up @@ -140,6 +141,7 @@ Mobile
Server
------------------------------

- 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>`__.
- Mattermost Enterprise Edition v11.6.0 - `View Open Source Components <https://github.com/mattermost/mattermost-server/blob/release-11.6/NOTICE.txt>`__.
- Mattermost Enterprise Edition v11.5.0 - `View Open Source Components <https://github.com/mattermost/mattermost-server/blob/release-11.5/NOTICE.txt>`__.
Expand Down
2 changes: 1 addition & 1 deletion source/deployment-guide/server/linux/deploy-rhel.rst
View file
Open in desktop
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.7.1/mattermost-11.7.1-linux-amd64.tar.gz
wget https://releases.mattermost.com/11.8.0/mattermost-11.8.0-linux-amd64.tar.gz
Comment thread
amyblais marked this conversation as resolved.

.. tab:: Current ESR

Expand Down
2 changes: 1 addition & 1 deletion source/deployment-guide/server/linux/deploy-tar.rst
View file
Open in desktop
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.7.1/mattermost-11.7.1-linux-amd64.tar.gz
wget https://releases.mattermost.com/11.8.0/mattermost-11.8.0-linux-amd64.tar.gz
Comment thread
amyblais marked this conversation as resolved.

.. tab:: Current ESR

Expand Down
2 changes: 1 addition & 1 deletion source/product-overview/mattermost-desktop-releases.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Mattermost releases a new desktop app version every 4 months, in February, May,

| **Release** | **Support** | **Compatible with** |
|:---|:---|:---|
| v6.2 [Download](https://github.com/mattermost/desktop/releases/tag/v6.2.0) \| {ref}`Changelog <release-v6-2>` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.2.0/sbom-desktop-v6.2.0.json) | Released: 2026-05-15<br/>Support Ends: 2027-05-15 {ref}`EXTENDED <release-types>` | {ref}`v11.7 <release-v11.7-extended-support-release>`, {ref}`v11.6 <release-v11.6-feature-release>`, {ref}`v11.5 <release-v11.5-feature-release>`, {ref}`v10.11 <release-v10.11-extended-support-release>` |
| v6.2 [Download](https://github.com/mattermost/desktop/releases/tag/v6.2.0) \| {ref}`Changelog <release-v6-2>` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.2.0/sbom-desktop-v6.2.0.json) | Released: 2026-05-15<br/>Support Ends: 2027-05-15 {ref}`EXTENDED <release-types>` | {ref}`v11.8 <release-v11.8-feature-release>`, {ref}`v11.7 <release-v11.7-extended-support-release>`, {ref}`v11.6 <release-v11.6-feature-release>`, {ref}`v11.5 <release-v11.5-feature-release>`, {ref}`v10.11 <release-v10.11-extended-support-release>` |
Comment thread
amyblais marked this conversation as resolved.
| v6.1 [Download](https://github.com/mattermost/desktop/releases/tag/v6.1.2) \| {ref}`Changelog <release-v6-1>` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.1.2/sbom-desktop-v6.1.2.json) | Released: 2026-03-02<br/>Support Ends: 2026-05-15 | {ref}`v11.6 <release-v11.6-feature-release>`, {ref}`v11.5 <release-v11.5-feature-release>`, {ref}`v11.4 <release-v11.4-feature-release>`, {ref}`v11.3 <release-v11.3-feature-release>`, {ref}`v11.2 <release-v11.2-feature-release>`, {ref}`v10.11 <release-v10.11-extended-support-release>` |
| v6.0 [Download](https://github.com/mattermost/desktop/releases/tag/v6.0.4) \| {ref}`Changelog <release-v6-0>` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.0.4/sbom-desktop-v6.0.4.json) | Released: 2025-11-14<br/>Support Ends: 2026-03-15 | {ref}`v11.4 <release-v11.4-feature-release>`, {ref}`v11.3 <release-v11.3-feature-release>`, {ref}`v11.2 <release-v11.2-feature-release>`, {ref}`v11.1 <release-v11.1-feature-release>`, {ref}`v11.0 <release-v11.0-major-release>`, {ref}`v10.12 <release-v10.12-feature-release>`, {ref}`v10.11 <release-v10.11-extended-support-release>` |
| v5.13 [Download](https://github.com/mattermost/desktop/releases/tag/v5.13.6) \| {ref}`Changelog <release-v5-13>` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v5.13.6/sbom-desktop-v5.13.6.json) | Released: 2025-08-15<br/>Support Ends: 2026-08-15 {ref}`EXTENDED <release-types>` | {ref}`v11.0 <release-v11.0-major-release>`, {ref}`v10.12 <release-v10.12-feature-release>`, {ref}`v10.11 <release-v10.11-extended-support-release>`, {ref}`v10.10 <release-v10.10-feature-release>`, {ref}`v10.9 <release-v10.9-feature-release>`, {ref}`v10.5 <release-v10.5-extended-support-release>` |
Expand Down
Loading
Loading