Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
8b504d7
Add Desktop App v6.2 ESR documentation
github-actions[bot] Apr 16, 2026
8261ea0
Update software-hardware-requirements.rst
amyblais Apr 16, 2026
c66eb86
Update mattermost-desktop-releases.md
amyblais Apr 16, 2026
aaa77f3
Update desktop-app-changelog.md
amyblais Apr 16, 2026
ea5e027
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais Apr 17, 2026
bbd8486
Update desktop-app-changelog.md
amyblais Apr 17, 2026
8a8509f
Update desktop-app-changelog.md
amyblais Apr 20, 2026
4c81681
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais Apr 20, 2026
949dc81
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais Apr 21, 2026
e8cef00
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais Apr 23, 2026
36fc8da
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais Apr 27, 2026
7202ece
Update desktop-app-changelog.md
amyblais Apr 27, 2026
f07bbe3
Update desktop-app-changelog.md
amyblais Apr 29, 2026
cc5010d
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais Apr 29, 2026
b4d1990
Update desktop-app-changelog.md
amyblais Apr 29, 2026
648baee
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais Apr 30, 2026
753144a
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais May 4, 2026
51075a5
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais May 7, 2026
a18ff1b
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais May 8, 2026
2c61da8
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais May 11, 2026
a9f12e1
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais May 12, 2026
2dc65f5
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais May 13, 2026
31d24cf
Merge branch 'master' into claude/issue-8900-20260416-1038
amyblais May 15, 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
Original file line number Diff line number Diff line change
Expand Up @@ -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.2 <https://github.com/mattermost/desktop/releases/latest>`__ 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 <https://github.com/mattermost/desktop/releases/latest>`__ and download the appropriate installer for your version of Windows (32-bit vs. 64-bit).
Comment thread
amyblais marked this conversation as resolved.
Comment thread
amyblais marked this conversation as resolved.

4. Download the `source.zip <https://github.com/mattermost/desktop/archive/v6.1.2.zip>`__ file as well to extract group policy files.
4. Download the `source.zip <https://github.com/mattermost/desktop/archive/v6.2.0.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.
Expand All @@ -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.2.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.2\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.
Expand Down Expand Up @@ -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.2-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.2-x64.msi /qn'``
**PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.2.0-x64.msi /qn'``

.. note::
- Replace ``<version>`` with the actual version number (e.g., ``v6.1.2``).
- Replace ``<version>`` with the actual version number (e.g., ``v6.2.0``).
Comment thread
amyblais marked this conversation as resolved.
- 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.
Expand All @@ -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.2-x64.msi APPLICATIONFOLDER="<install directory>"``
- **PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.1.2-x64.msi APPLICATIONFOLDER="<install directory>"'``
- **Command Prompt:** ``msiexec /i mattermost-desktop-v6.2.0-x64.msi APPLICATIONFOLDER="<install directory>"``
- **PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.2.0-x64.msi APPLICATIONFOLDER="<install directory>"'``

Change this command as new versions of the Mattermost Desktop App are released.
10 changes: 5 additions & 5 deletions source/deployment-guide/desktop/linux-desktop-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -57,21 +57,21 @@ 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.2-linux-x86_64.rpm <https://releases.mattermost.com/desktop/6.1.2/mattermost-desktop-6.1.2-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 <https://releases.mattermost.com/desktop/6.2.0/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.2-linux-x86_64.rpm
sudo rpm -i mattermost-desktop-6.2.0-linux-x86_64.rpm

3. Run Mattermost as a desktop app.

To manually update the desktop app, run the following command:

.. code-block:: sh

sudo rpm -u mattermost-desktop-6.1.2-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...**.
Expand Down Expand Up @@ -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.2``) 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:

Expand Down Expand Up @@ -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.2-linux-x64.tar.gz <https://releases.mattermost.com/desktop/6.1.2/mattermost-desktop-6.1.2-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 <https://releases.mattermost.com/desktop/6.2.0/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``

Expand Down
8 changes: 4 additions & 4 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", "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 <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 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
^^^^^^^^^^^^
Expand Down
64 changes: 64 additions & 0 deletions source/product-overview/desktop-app-changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,70 @@ 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)

**Release Day: 2026-05-15**

**Download Binaries:** [Mattermost Desktop on GitHub](https://github.com/mattermost/desktop/releases/latest)
Comment thread
amyblais marked this conversation as resolved.

### Compatibility

- Desktop App is supported on any currently supported [Mattermost server version](https://docs.mattermost.com/product-overview/mattermost-desktop-releases.html#latest-releases).
Comment thread
amyblais marked this conversation as resolved.
Comment thread
amyblais marked this conversation as resolved.
- 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

#### Windows
- Fixed an issue where the loading screen could get stuck over the top of the app.

#### 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 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.
- Fixed an issue where the **Settings** modal could not be opened when no servers were configured.
- Fixed an issue where overly long URLs were not handled correctly.
- Fixed an issue related to authentication on non-configured domains.

### Open Source Components

- Added ``cf-prefs`` to https://github.com/mattermost/desktop.

### Known Issues

- 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.
Comment thread
amyblais marked this conversation as resolved.
- 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/<username>/Library/Containers/Mattermost/Data/Library/Application Support/Mattermost`, for Windows in `Users/<username>/AppData/Roaming/Mattermost` and for Linux in `~/config/Mattermost` (where `~` is the home directory).
Comment thread
amyblais marked this conversation as resolved.
Comment thread
amyblais marked this conversation as resolved.
- 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

Expand Down
1 change: 1 addition & 0 deletions source/product-overview/mattermost-desktop-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <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>` |
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