From 8b504d7cc7a6f46816f6871fe818282fdfcd72dc Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Thu, 16 Apr 2026 10:44:36 +0000 Subject: [PATCH 1/6] Add Desktop App v6.2 ESR documentation - Add v6.2 ESR entry to desktop releases table (released 2026-05-16, support ends 2027-05-15) - Add v6.2 changelog section to desktop-app-changelog.md - Update Linux install instructions from v6.1.1 to v6.2.0 - Update MSI installer guide from v6.1.1 to v6.2.0 Resolves #8900 Co-authored-by: Amy Blais --- ...msi-installer-and-group-policy-install.rst | 18 ++++++++-------- .../desktop/linux-desktop-install.rst | 10 ++++----- .../product-overview/desktop-app-changelog.md | 21 +++++++++++++++++++ .../mattermost-desktop-releases.md | 1 + 4 files changed, 36 insertions(+), 14 deletions(-) diff --git a/source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst b/source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst index aa308a1e0b2..de186274c36 100644 --- a/source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst +++ b/source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst @@ -47,9 +47,9 @@ Download group policy and MSI installer files .. image:: ../../images/desktop/msi_gpo/msi_gpo_installation_test_00002.png :alt: Go to the mattermost/desktop repository on GitHub. -3. Navigate to the release page for `version v6.1.1 `__ and download the appropriate installer for your version of Windows (32-bit vs. 64-bit). +3. Navigate to the release page for `version v6.2.0 `__ and download the appropriate installer for your version of Windows (32-bit vs. 64-bit). -4. Download the `source.zip `__ file as well to extract group policy files. +4. Download the `source.zip `__ file as well to extract group policy files. .. image:: ../../images/desktop/msi_gpo/msi_gpo_installation_test_00003.png :alt: In the mattermost/desktop repository on GitHub, go to the release page for the latest desktop release, then download the installer for your version of Windows. Download the source.zip file as well to extract group policy files. @@ -70,12 +70,12 @@ The following group policies are available supporting a state option of Not Conf | Update Notifications | If disabled, in-app update notifications are not shown. | v5.1 or later | ``EnableAutoUpdates`` | +--------------------------+------------------------------------------------------------+----------------------+----------------------------+ -1. Browse to the folder the above files were downloaded to and unzip the ``desktop-6.1.1.zip`` file in place. +1. Browse to the folder the above files were downloaded to and unzip the ``desktop-6.2.0.zip`` file in place. .. image:: ../../images/desktop/msi_gpo/msi_gpo_installation_test_00004.png :alt: Go to the install download directory on your machine and unzip the ZIP file. -2. Navigate to the unzipped ``desktop-6.1.1\resources\windows\gpo`` folder and copy the contents. +2. Navigate to the unzipped ``desktop-6.2.0\resources\windows\gpo`` folder and copy the contents. .. image:: ../../images/desktop/msi_gpo/msi_gpo_installation_test_00005.png :alt: Go to the \resources\windows\gpo directory and copy its contents. @@ -210,12 +210,12 @@ Perform a silent installation of the MSI by running the following command: Ensure the desktop app is closed before proceeding with a silent installation. Because it's a silent installation, Mattermost won't prompt you to close the desktop app. -**Command Prompt:** ``msiexec /i mattermost-desktop-v6.1.1-x64.msi /qn`` +**Command Prompt:** ``msiexec /i mattermost-desktop-v6.2.0-x64.msi /qn`` -**PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.1.1-x64.msi /qn'`` +**PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.2.0-x64.msi /qn'`` .. note:: - - Replace ```` with the actual version number (e.g., ``v6.1.1``). + - Replace ```` with the actual version number (e.g., ``v6.2.0``). - From v6.1.0, the MSI installs per-machine by default, requiring administrator privileges. From version v5.9.0 of the Mattermost desktop app, the following silent MSI installation options are also available. @@ -225,7 +225,7 @@ Specify an install directory Use the ``APPLICATIONFOLDER`` parameter to specify an installation directory for the MSI installation: -- **Command Prompt:** ``msiexec /i mattermost-desktop-v6.1.1-x64.msi APPLICATIONFOLDER=""`` -- **PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.1.1-x64.msi APPLICATIONFOLDER=""'`` +- **Command Prompt:** ``msiexec /i mattermost-desktop-v6.2.0-x64.msi APPLICATIONFOLDER=""`` +- **PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.2.0-x64.msi APPLICATIONFOLDER=""'`` Change this command as new versions of the Mattermost Desktop App are released. diff --git a/source/deployment-guide/desktop/linux-desktop-install.rst b/source/deployment-guide/desktop/linux-desktop-install.rst index 0a10a43c844..cb9777c94cc 100644 --- a/source/deployment-guide/desktop/linux-desktop-install.rst +++ b/source/deployment-guide/desktop/linux-desktop-install.rst @@ -57,13 +57,13 @@ This page describes how to install the Mattermost desktop app on Linux. Install the Mattermost desktop app ---------------------------------- - 1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-6.1.1-linux-x86_64.rpm `_ + 1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-6.2.0-linux-x86_64.rpm `_ 2. At the command line, execute the following command: .. code-block:: sh - sudo rpm -i mattermost-desktop-6.1.1-linux-x86_64.rpm + sudo rpm -i mattermost-desktop-6.2.0-linux-x86_64.rpm 3. Run Mattermost as a desktop app. @@ -71,7 +71,7 @@ This page describes how to install the Mattermost desktop app on Linux. .. code-block:: sh - sudo rpm -u mattermost-desktop-6.1.1-linux-x86_64.rpm + sudo rpm -u mattermost-desktop-6.2.0-linux-x86_64.rpm .. tip:: You can review the current version of your desktop app by selecting the **More** |more-icon-vertical| icon located in the top left corner of the desktop app, then selecting **Help > Version...**. @@ -109,7 +109,7 @@ This page describes how to install the Mattermost desktop app on Linux. flatpak install mattermost-desktop-{VERSION}-linux-{ARCH}.flatpak - Replace ``{VERSION}`` with the version number (e.g., ``6.1.1``) and ``{ARCH}`` with your architecture (``x86_64`` or ``aarch64``). + Replace ``{VERSION}`` with the version number (e.g., ``6.2.0``) and ``{ARCH}`` with your architecture (``x86_64`` or ``aarch64``). 4. Run Mattermost as a desktop app: @@ -137,7 +137,7 @@ This page describes how to install the Mattermost desktop app on Linux. Install the Desktop App's compressed tarball --------------------------------------------- - 1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-6.1.1-linux-x64.tar.gz `_ + 1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-6.2.0-linux-x64.tar.gz `_ 2. Extract the archive to a convenient location, then give ``chrome-sandbox`` in the extracted directory the required ownership and permissions: ``sudo chown root:root chrome-sandbox && sudo chmod 4755 chrome-sandbox`` diff --git a/source/product-overview/desktop-app-changelog.md b/source/product-overview/desktop-app-changelog.md index 5d667e01b4f..4e447c9bc33 100644 --- a/source/product-overview/desktop-app-changelog.md +++ b/source/product-overview/desktop-app-changelog.md @@ -6,6 +6,27 @@ This changelog summarizes updates to Mattermost desktop app releases for [Matter ```{include} common-esr-support.md ``` +(release-v6-2)= +## Release v6.2 (Extended Support Release) + +- **v6.2.0, released 2026-05-16** + + - Original v6.2.0 release + +**Download Binaries:** [Mattermost Desktop on GitHub](https://github.com/mattermost/desktop/releases/v6.2.0) + +### Compatibility + +- Desktop App is supported on any currently supported [Mattermost server version](https://docs.mattermost.com/product-overview/mattermost-desktop-releases.html#latest-releases). + +### Known Issues + +- Sometimes the app will not restart after an auto-update. This is normal, and if this occurs the app can be safely launched manually. +- Sometimes during installation you may see this message: ``Warning 1946. Property 'System.AppUserModel.ID' for shortcut 'Mattermost.Ink' could not be set``. This message can be safely ignored. +- Users seeing an endless "Loading..." screen when attempting to log in to the app may need to manually delete their cache directory. For macOS it is located in `/Users//Library/Containers/Mattermost/Data/Library/Application Support/Mattermost`, for Windows in `Users//AppData/Roaming/Mattermost` and for Linux in `~/config/Mattermost` (where `~` is the home directory). +- On Linux, a left-click on the Mattermost tray icon doesn't open the app window but opens the tray menu. +- Crashes might be experienced in some Linux desktop clients due to an upstream bug in the `libnotifyapp` library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings. + (release-v6-1)= ## Release v6.1 diff --git a/source/product-overview/mattermost-desktop-releases.md b/source/product-overview/mattermost-desktop-releases.md index 8247e039336..4bf684e3bef 100644 --- a/source/product-overview/mattermost-desktop-releases.md +++ b/source/product-overview/mattermost-desktop-releases.md @@ -18,6 +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 ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.2.0/sbom-desktop-v6.2.0.json) | Released: 2026-05-16
Support Ends: 2027-05-15 {ref}`EXTENDED ` | {ref}`v11.7 `, {ref}`v11.6 `, {ref}`v11.5 `, {ref}`v11.4 `, {ref}`v11.3 `, {ref}`v10.11 ` | | v6.1 [Download](https://github.com/mattermost/desktop/releases/tag/v6.1.1) \| {ref}`Changelog ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.1.1/sbom-desktop-v6.1.1.json) | Released: 2026-03-02
Support Ends: 2026-05-15 | {ref}`v11.6 `, {ref}`v11.5 `, {ref}`v11.4 `, {ref}`v11.3 `, {ref}`v11.2 `, {ref}`v10.11 ` | | v6.0 [Download](https://github.com/mattermost/desktop/releases/tag/v6.0.4) \| {ref}`Changelog ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.0.4/sbom-desktop-v6.0.4.json) | Released: 2025-11-14
Support Ends: 2026-03-15 | {ref}`v11.4 `, {ref}`v11.3 `, {ref}`v11.2 `, {ref}`v11.1 `, {ref}`v11.0 `, {ref}`v10.12 `, {ref}`v10.11 ` | | v5.13 [Download](https://github.com/mattermost/desktop/releases/tag/v5.13.5) \| {ref}`Changelog ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v5.13.5/sbom-desktop-v5.13.5.json) | Released: 2025-08-15
Support Ends: 2026-08-15 {ref}`EXTENDED ` | {ref}`v11.0 `, {ref}`v10.12 `, {ref}`v10.11 `, {ref}`v10.10 `, {ref}`v10.9 `, {ref}`v10.5 ` | From 8261ea0d37d976b596ed8c51f5aebbba22792521 Mon Sep 17 00:00:00 2001 From: Amy Blais <29708087+amyblais@users.noreply.github.com> Date: Thu, 16 Apr 2026 13:46:36 +0300 Subject: [PATCH 2/6] Update software-hardware-requirements.rst --- .../deployment-guide/software-hardware-requirements.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/deployment-guide/software-hardware-requirements.rst b/source/deployment-guide/software-hardware-requirements.rst index 939ac179a01..4d0c1685e49 100644 --- a/source/deployment-guide/software-hardware-requirements.rst +++ b/source/deployment-guide/software-hardware-requirements.rst @@ -50,10 +50,10 @@ PC web .. csv-table:: :header: "Browser", "Self-Hosted Technical Requirement", "Cloud Technical Requirement" - "Chrome", "v144+", "v144+" + "Chrome", "v146+", "v146+" "Firefox", "v140+", "v140+" "Safari", "v26.2+", "v26.2+" - "Edge", "v144+", "v144+" + "Edge", "v146+", "v146+" `*` Internet Explorer (IE11) is no longer supported. We recommend using the `Mattermost desktop app `_ or another supported browser. See `this forum post `__ to learn more. @@ -78,8 +78,8 @@ Mobile web .. csv-table:: :header: "Browser", "Technical Requirement" - "iOS", "iOS 16.0+ with Safari 26.2+ or Chrome 144+" - "Android", "Android 7+ with Chrome 144+" + "iOS", "iOS 16.0+ with Safari 26.2+ or Chrome 146+" + "Android", "Android 7+ with Chrome 146+" Email client ^^^^^^^^^^^^ From c66eb866b719369abd68cf0637627d6f51f16bbd Mon Sep 17 00:00:00 2001 From: Amy Blais <29708087+amyblais@users.noreply.github.com> Date: Thu, 16 Apr 2026 13:49:31 +0300 Subject: [PATCH 3/6] Update mattermost-desktop-releases.md --- source/product-overview/mattermost-desktop-releases.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/product-overview/mattermost-desktop-releases.md b/source/product-overview/mattermost-desktop-releases.md index 4bf684e3bef..1ef61d22f7d 100644 --- a/source/product-overview/mattermost-desktop-releases.md +++ b/source/product-overview/mattermost-desktop-releases.md @@ -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 ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.2.0/sbom-desktop-v6.2.0.json) | Released: 2026-05-16
Support Ends: 2027-05-15 {ref}`EXTENDED ` | {ref}`v11.7 `, {ref}`v11.6 `, {ref}`v11.5 `, {ref}`v11.4 `, {ref}`v11.3 `, {ref}`v10.11 ` | +| v6.2 [Download](https://github.com/mattermost/desktop/releases/tag/v6.2.0) \| {ref}`Changelog ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.2.0/sbom-desktop-v6.2.0.json) | Released: 2026-05-15
Support Ends: 2027-05-15 {ref}`EXTENDED ` | {ref}`v11.7 `, {ref}`v11.6 `, {ref}`v11.5 `, {ref}`v10.11 ` | | v6.1 [Download](https://github.com/mattermost/desktop/releases/tag/v6.1.1) \| {ref}`Changelog ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.1.1/sbom-desktop-v6.1.1.json) | Released: 2026-03-02
Support Ends: 2026-05-15 | {ref}`v11.6 `, {ref}`v11.5 `, {ref}`v11.4 `, {ref}`v11.3 `, {ref}`v11.2 `, {ref}`v10.11 ` | | v6.0 [Download](https://github.com/mattermost/desktop/releases/tag/v6.0.4) \| {ref}`Changelog ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.0.4/sbom-desktop-v6.0.4.json) | Released: 2025-11-14
Support Ends: 2026-03-15 | {ref}`v11.4 `, {ref}`v11.3 `, {ref}`v11.2 `, {ref}`v11.1 `, {ref}`v11.0 `, {ref}`v10.12 `, {ref}`v10.11 ` | | v5.13 [Download](https://github.com/mattermost/desktop/releases/tag/v5.13.5) \| {ref}`Changelog ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v5.13.5/sbom-desktop-v5.13.5.json) | Released: 2025-08-15
Support Ends: 2026-08-15 {ref}`EXTENDED ` | {ref}`v11.0 `, {ref}`v10.12 `, {ref}`v10.11 `, {ref}`v10.10 `, {ref}`v10.9 `, {ref}`v10.5 ` | From aaa77f33fa113f68c451b043ab26291355b1a016 Mon Sep 17 00:00:00 2001 From: Amy Blais <29708087+amyblais@users.noreply.github.com> Date: Thu, 16 Apr 2026 13:55:32 +0300 Subject: [PATCH 4/6] Update desktop-app-changelog.md --- .../product-overview/desktop-app-changelog.md | 47 +++++++++++++++++-- 1 file changed, 43 insertions(+), 4 deletions(-) diff --git a/source/product-overview/desktop-app-changelog.md b/source/product-overview/desktop-app-changelog.md index 4e447c9bc33..c4e43124e1e 100644 --- a/source/product-overview/desktop-app-changelog.md +++ b/source/product-overview/desktop-app-changelog.md @@ -9,15 +9,50 @@ This changelog summarizes updates to Mattermost desktop app releases for [Matter (release-v6-2)= ## Release v6.2 (Extended Support Release) -- **v6.2.0, released 2026-05-16** +**Release Day: 2026-05-15** - - Original v6.2.0 release - -**Download Binaries:** [Mattermost Desktop on GitHub](https://github.com/mattermost/desktop/releases/v6.2.0) +**Download Binaries:** [Mattermost Desktop on GitHub](https://github.com/mattermost/desktop/releases/latest) ### Compatibility - Desktop App is supported on any currently supported [Mattermost server version](https://docs.mattermost.com/product-overview/mattermost-desktop-releases.html#latest-releases). +- Updated Chromium minimum supported version to 146+. + +### Improvements + +#### macOS + +- Added support for macOS MDM. + +#### Linux + +- Added a setting to enable native window decorations on Linux. + +#### All Platforms + +- Added a "Copy Email Address" option to the right-click context menu for mailto links. +- Enabled drag-and-drop re-ordering for predefined servers. + +### Architectural Changes + +- Major version upgrade of Electron to v41.2.0. Electron is the underlying technology used to build the Desktop App. + +### Bug Fixes + +#### All Platforms + +- Fixed issues related to default preferences not applying to local configuration. +- Fixed a misleading error message in the **Developer Tools** for the main window. +- Fixed an issue where the loading screen could get stuck over the top of the app. +- Fixed an issue where invalid server URLs were not preserved in the **Add Server** textbox. +- Fixed an issue where removing a server with unreads or mentions caused the badge indicator to become stuck until the app was restarted. +- Fixed an issue where renaming a server while not logged in did not update the tab title. +- Fixed a crash that could occur when the main window was closed while server views were still sending status updates. +- Fixed an issue where clicking custom protocol links could open the target application with a malformed URL. + +### Open Source Components + +- Added ``cf-prefs`` to https://github.com/mattermost/desktop. ### Known Issues @@ -27,6 +62,10 @@ This changelog summarizes updates to Mattermost desktop app releases for [Matter - On Linux, a left-click on the Mattermost tray icon doesn't open the app window but opens the tray menu. - Crashes might be experienced in some Linux desktop clients due to an upstream bug in the `libnotifyapp` library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings. +### Contributors + +- [davidpaquin](https://github.com/davidpaquin), [devinbinnie](https://github.com/devinbinnie). + (release-v6-1)= ## Release v6.1 From bbd8486914abb360dfa2b75c0259a82592446053 Mon Sep 17 00:00:00 2001 From: Amy Blais <29708087+amyblais@users.noreply.github.com> Date: Fri, 17 Apr 2026 16:17:41 +0300 Subject: [PATCH 5/6] Update desktop-app-changelog.md --- source/product-overview/desktop-app-changelog.md | 1 - 1 file changed, 1 deletion(-) diff --git a/source/product-overview/desktop-app-changelog.md b/source/product-overview/desktop-app-changelog.md index c4e43124e1e..a8897f19f9a 100644 --- a/source/product-overview/desktop-app-changelog.md +++ b/source/product-overview/desktop-app-changelog.md @@ -56,7 +56,6 @@ This changelog summarizes updates to Mattermost desktop app releases for [Matter ### Known Issues -- Sometimes the app will not restart after an auto-update. This is normal, and if this occurs the app can be safely launched manually. - Sometimes during installation you may see this message: ``Warning 1946. Property 'System.AppUserModel.ID' for shortcut 'Mattermost.Ink' could not be set``. This message can be safely ignored. - Users seeing an endless "Loading..." screen when attempting to log in to the app may need to manually delete their cache directory. For macOS it is located in `/Users//Library/Containers/Mattermost/Data/Library/Application Support/Mattermost`, for Windows in `Users//AppData/Roaming/Mattermost` and for Linux in `~/config/Mattermost` (where `~` is the home directory). - On Linux, a left-click on the Mattermost tray icon doesn't open the app window but opens the tray menu. From 8a8509faf109872ba3df15a186edb81632510d63 Mon Sep 17 00:00:00 2001 From: Amy Blais <29708087+amyblais@users.noreply.github.com> Date: Mon, 20 Apr 2026 08:25:30 +0300 Subject: [PATCH 6/6] Update desktop-app-changelog.md --- source/product-overview/desktop-app-changelog.md | 1 + 1 file changed, 1 insertion(+) diff --git a/source/product-overview/desktop-app-changelog.md b/source/product-overview/desktop-app-changelog.md index a8897f19f9a..6bcf28d7ca4 100644 --- a/source/product-overview/desktop-app-changelog.md +++ b/source/product-overview/desktop-app-changelog.md @@ -49,6 +49,7 @@ This changelog summarizes updates to Mattermost desktop app releases for [Matter - Fixed an issue where renaming a server while not logged in did not update the tab title. - Fixed a crash that could occur when the main window was closed while server views were still sending status updates. - Fixed an issue where clicking custom protocol links could open the target application with a malformed URL. +- Fixed an issue where the **Settings** modal could not be opened when no servers were configured. ### Open Source Components