Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
56 commits
Select commit Hold shift + click to select a range
dadfdce
Update documentation for Desktop app v6.1 release
claude[bot] Jan 16, 2026
6ca69f7
Update mattermost-desktop-releases.md
amyblais Jan 16, 2026
2cf351d
Update desktop-app-changelog.md
amyblais Jan 16, 2026
0f17791
Update software-hardware-requirements.rst
amyblais Jan 16, 2026
5709c9a
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Jan 19, 2026
24db2f2
Update desktop-app-changelog.md
amyblais Jan 19, 2026
d30e0ee
Update desktop-app-changelog.md
amyblais Jan 20, 2026
59937b1
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Jan 20, 2026
b470477
Update deprecated-features.rst
amyblais Jan 20, 2026
8d67c47
Update desktop-app-changelog.md
amyblais Jan 20, 2026
9054cd1
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Jan 21, 2026
6337c87
Update desktop-app-changelog.md
amyblais Jan 21, 2026
727fc09
Update desktop-app-changelog.md
amyblais Jan 22, 2026
8de767f
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Jan 22, 2026
94c5ba7
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Jan 22, 2026
376453e
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Jan 23, 2026
fd9e02f
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Jan 26, 2026
61260bc
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Jan 27, 2026
630672b
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Jan 28, 2026
26c5b2e
Update desktop-app-changelog.md
amyblais Jan 28, 2026
acfe357
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Jan 29, 2026
91e19f5
Update desktop-app-changelog.md
amyblais Jan 30, 2026
9e682d2
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Jan 30, 2026
0ba3daf
Update desktop-app-changelog.md
amyblais Jan 30, 2026
145b15e
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Feb 2, 2026
43529e2
Update desktop-app-changelog.md
amyblais Feb 2, 2026
a4118b9
Update desktop-app-changelog.md
amyblais Feb 2, 2026
a4bf064
Update desktop-app-changelog.md
amyblais Feb 2, 2026
73be850
Update software-hardware-requirements.rst
amyblais Feb 2, 2026
1879551
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Feb 3, 2026
70d4b9b
Update software-hardware-requirements.rst
amyblais Feb 3, 2026
715e3f1
Update desktop-app-changelog.md
amyblais Feb 3, 2026
220039a
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Feb 4, 2026
a28f768
Update desktop-app-changelog.md
amyblais Feb 4, 2026
0a94d7d
Update desktop-app-changelog.md
amyblais Feb 4, 2026
567a7b7
Update desktop-msi-installer-and-group-policy-install.rst
amyblais Feb 4, 2026
9032098
Update desktop-msi-installer-and-group-policy-install.rst
amyblais Feb 4, 2026
79c2aeb
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Feb 6, 2026
360c6d9
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Feb 9, 2026
5d9f3d0
Update desktop-app-changelog.md
amyblais Feb 10, 2026
7eee32b
Update desktop-app-changelog.md
amyblais Feb 10, 2026
e445f93
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Feb 11, 2026
632e7b3
Update desktop-app-changelog.md
amyblais Feb 11, 2026
04a9464
Update desktop-app-changelog.md
amyblais Feb 11, 2026
2ab7c2f
Apply suggestions from code review
amyblais Feb 12, 2026
c039417
Update desktop-app-changelog.md
amyblais Feb 12, 2026
f9d6b23
Update desktop-msi-installer-and-group-policy-install.rst
amyblais Feb 12, 2026
02c90bf
Update desktop-msi-installer-and-group-policy-install.rst
amyblais Feb 12, 2026
5a73377
Update deprecated-features.rst
amyblais Feb 12, 2026
7bb4184
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Feb 12, 2026
2e09134
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Feb 13, 2026
53909f3
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Feb 16, 2026
dd88786
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Feb 18, 2026
51609fe
Merge branch 'master' into claude/issue-8635-20260116-1209
amyblais Feb 20, 2026
a995c3d
Update desktop-app-changelog.md
amyblais Feb 20, 2026
5123a00
Update desktop-app-changelog.md
amyblais Feb 24, 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 @@ -4,7 +4,7 @@ Desktop MSI installer and group policy guide
.. include:: ../../_static/badges/all-commercial.rst
:start-after: :nosearch:

This page provides guidance on installing the desktop app MSI and use Group Policies in Windows for Mattermost Enterprise or Professional. The MSI installer package can be downloaded `here <https://github.com/mattermost/desktop/releases/tag/v6.0.4>`_.
This page provides guidance on installing the desktop app MSI and use Group Policies in Windows for Mattermost Enterprise or Professional. The MSI installer package can be downloaded `here <https://github.com/mattermost/desktop/releases/latest>`_.

.. tip::

Expand All @@ -23,9 +23,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.0.4 <https://github.com/mattermost/desktop/releases/tag/v6.0.4>`__ and download the appropriate installer for your version of Windows (32-bit vs. 64-bit).
3. Navigate to the release page for `version v6.1.0 <https://github.com/mattermost/desktop/releases/latest>`__ and download the appropriate installer for your version of Windows (32-bit vs. 64-bit).

4. Download the `source.zip <https://github.com/mattermost/desktop/archive/v6.0.4.zip>`__ file as well to extract group policy files.
4. Download the `source.zip <https://github.com/mattermost/desktop/archive/v6.1.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 @@ -46,12 +46,12 @@ The following group policies are available supporting a state option of Not Conf
| Automatic Updates | If disabled, automatic desktop app updates are disabled. | v5.1 or later | ``EnableAutoUpdates`` |
+--------------------------+------------------------------------------------------------+----------------------+----------------------------+

1. Browse to the folder the above files were downloaded to and unzip the ``desktop-6.0.3.zip`` file in place.
1. Browse to the folder the above files were downloaded to and unzip the ``desktop-6.1.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.0.3\resources\windows\gpo`` folder and copy the contents.
2. Navigate to the unzipped ``desktop-6.1.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 @@ -179,34 +179,21 @@ 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.0.4-x64.msi /qn``
**Command Prompt:** ``msiexec /i mattermost-desktop-v6.1.0-x64.msi /qn``

**PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.0.4-x64.msi /qn'``
**PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.1.0-x64.msi /qn'``

.. note::
- You'll need to update the version details in this command as new versions of the Mattermost desktop app are released.

From version v5.9.0 of the Mattermost desktop app, the following silent MSI installation options are also available.

Install for all users
~~~~~~~~~~~~~~~~~~~~~

Use the ``ALLUSERS`` parameter to install the MSI for all users:

**Command Prompt:** ``msiexec /i mattermost-desktop-v6.0.4-x64.msi ALLUSERS=1``

**PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.0.4-x64.msi ALLUSERS=1'``

.. note::
- Installing the MSI for all users disables automatic updates for the desktop app on Windows.
- To disable automatic updates on a per-user basis, use the ``DISABLEAUTOUPDATE`` parameter: ``msiexec /i mattermost-desktop-v6.0.4-x64.msi DISABLEAUTOUPDATE=1``

Specify an install directory
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Use the ``APPLICATIONFOLDER`` parameter to specify an installation directory for the MSI installation:

- **Command Prompt:** ``msiexec /i mattermost-desktop-v6.0.4-x64.msi APPLICATIONFOLDER="<install directory>"``
- **PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.0.4-x64.msi APPLICATIONFOLDER="<install directory>"'``
- **Command Prompt:** ``msiexec /i mattermost-desktop-v6.1.0-x64.msi APPLICATIONFOLDER="<install directory>"``
- **PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.1.0-x64.msi APPLICATIONFOLDER="<install directory>"'``

Change this command as new versions of the Mattermost Desktop App are released.
Change this command as new versions of the Mattermost Desktop App are released.
8 changes: 4 additions & 4 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.0.4-linux-x86_64.rpm <https://releases.mattermost.com/desktop/6.0.4/mattermost-desktop-6.0.4-linux-x86_64.rpm>`_
1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-6.1.0-linux-x86_64.rpm <https://releases.mattermost.com/desktop/6.1.0/mattermost-desktop-6.1.0-linux-x86_64.rpm>`_

2. At the command line, execute the following command:

.. code-block:: sh

sudo rpm -i mattermost-desktop-6.0.4-linux-x86_64.rpm
sudo rpm -i mattermost-desktop-6.1.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.0.4-linux-x86_64.rpm
sudo rpm -u mattermost-desktop-6.1.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 All @@ -86,7 +86,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.0.4-linux-x64.tar.gz <https://releases.mattermost.com/desktop/6.0.4/mattermost-desktop-6.0.4-linux-x64.tar.gz>`_
1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-6.1.0-linux-x64.tar.gz <https://releases.mattermost.com/desktop/6.1.0/mattermost-desktop-6.1.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/product-overview/deprecated-features.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@ This page describes features that are removed from support for Mattermost, or wi
Removed features in upcoming versions
-------------------------------------

Removed features by Mattermost version
----------------------------------------

Mattermost Desktop App v6.1 (February 2026)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- The in-app auto-updater for Windows and Linux AppImage installations will be deprecated. See more details in `this forum post <https://forum.mattermost.com/t/important-update-changes-to-desktop-app-auto-updater/25657>`__.

Removed features by Mattermost version
----------------------------------------
- The in-app auto-updater for Windows and Linux AppImage installations has been deprecated. See more details in `this forum post <https://forum.mattermost.com/t/important-update-changes-to-desktop-app-auto-updater/25657>`__.

Mattermost Server v11.4 (February 2026)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down
84 changes: 83 additions & 1 deletion source/product-overview/desktop-app-changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,88 @@ This changelog summarizes updates to Mattermost desktop app releases for [Matter
```{include} common-esr-support.md
```

(release-v6-1)=
## Release v6.1

**v6.1.0 Release Day: TBD**

**Download Binaries:** [Mattermost Desktop on GitHub](https://github.com/mattermost/desktop/releases/latest)

### Important Upgrade Notes

- The in-app auto-updater for Windows and Linux AppImage installations has been deprecated. See more details in [this forum post](https://forum.mattermost.com/t/important-update-changes-to-desktop-app-auto-updater/25657).

### 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 144+.

### Improvements

#### macOS

- Removed MAS (Mac App Store) migration logic [MM-66704](https://mattermost.atlassian.net/browse/MM-66704).
- Changed the name of the macOS ARM64 DMG from ``m1`` to ``arm64`` [MM-54413](https://mattermost.atlassian.net/browse/MM-54413).

#### Windows

- Forced [MSI to install per-machine](https://docs.mattermost.com/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.html) by default. See Known Issues below for more details.
- Removed the [Windows EXE installer](https://docs.mattermost.com/deployment-guide/desktop/silent-windows-desktop-distribution.html).

#### Linux
- Added [Flatpak](https://docs.mattermost.com/deployment-guide/desktop/linux-desktop-install.html) to Linux-packaged builds.

#### All Platforms

- Added support for servers with passwordless authentication with [Magic Link for guest users](https://docs.mattermost.com/end-user-guide/access/access-your-workspace.html#magic-link-login-for-guests) (requires Enterprise license) [MM-66445](https://mattermost.atlassian.net/browse/MM-66445).
- Added [Sentry error tracking](https://docs.mattermost.com/deployment-guide/desktop/desktop-app-deployment.html#privacy-and-data-handling).
- Added [in-app notifications for new versions](https://docs.mattermost.com/end-user-guide/access/install-desktop-app.html#upgrade-the-desktop-app), including for Mac App Store and the Windows MSI.

### Architectural Changes

- Major version upgrade of Electron to v40.6.0. Electron is the underlying technology used to build the Desktop App.

### Bug Fixes

#### macOS

- Fixed an issue where macOS permission dialogs were specifically referencing Jitsi instead of using general wording [MM-66775](https://mattermost.atlassian.net/browse/MM-66775).

#### Windows

- Fixed an issue where installing over top of an old Desktop App on Windows could break the shortcut. NOTE: You may need to [remake your shortcut](https://docs.mattermost.com/deployment-guide/desktop/desktop-troubleshooting.html) in the taskbar once after this change [MM-63779](https://mattermost.atlassian.net/browse/MM-63779).
- Fixed an issue where the notification badge on Windows could get out of sync.

#### All Platforms

- Fixed a potential crash in the context menu [MM-66902](https://mattermost.atlassian.net/browse/MM-66902).
- Fixed an unnecessary exception handler dialog box appearing when clicking **Clear All Data** [MM-64601](https://mattermost.atlassian.net/browse/MM-64601).
- Fixed an issue where Microsoft Teams, SharePoint, and OneNote links were incorrectly rejected as "Invalid Link" due to special characters in their URLs [MM-65645](https://mattermost.atlassian.net/browse/MM-65645).
- Fixed an issue where clicking the tray menu items would not open the main window.
- Fixed an issue where clicking the tray menu items would not open the main window if it was occluded.
- Fixed an issue where Sentry and anonymous server metrics were not enabled by default.
- Fixed an issue where the Desktop App wouldn't load content from the JIRA plugin in certain cases.

### Open Source Components

- Added ``@sentry/electron`` and removed ``electron-updater`` from https://github.com/mattermost/desktop.

### Known Issues

- For Calls to work properly with Desktop 6.1, one must use RTCD v1.2.5 (if using external RTCD server) or Calls plugin v1.11.1 (if using integrated RTCD).
- Desktop App v6.1 has been tested against our existing EXE and MSI installers, with a few caveats:
- When installing over top of the MSI installer for versions below v5.9, an extra shortcut may be left in the user's start menu. This can be safely deleted.
- When installing over top of the MSI installer for versions from v5.9 to v6.0.4, if the installation was done per-user (as is the default), the new installer will not replace the old one. This is due to the fact that MSIs cannot modify across contexts, so as a one-time fix, users will have to manually uninstall the old one. We recommend doing this before installing the new one.
- 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/<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).
- 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

- [devinbinnie](https://github.com/devinbinnie), [enahum](https://github.com/enahum), [hmhealey](https://github.com/hmhealey), [lieut-data](https://github.com/lieut-data), [lifeisafractal](https://github.com/lifeisafractal), [NARSimoes](https://github.com/NARSimoes), [wiggin77](https://github.com/wiggin77), [yasserfaraazkhan](https://github.com/yasserfaraazkhan).

(release-v6-0)=
## Release v6.0

Expand Down Expand Up @@ -40,7 +122,7 @@ This changelog summarizes updates to Mattermost desktop app releases for [Matter

- Original v6.0.0 release

**Download Binaries:** [Mattermost Desktop on GitHub](https://github.com/mattermost/desktop/releases/latest)
**Download Binaries:** [Mattermost Desktop on GitHub](https://github.com/mattermost/desktop/releases/v6.0.4)

```{Note}
Mattermost Desktop App v6.0.0 contains low severity level security fixes. Upgrading is recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
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.1 [Download](https://github.com/mattermost/desktop/releases/tag/v6.1.0) \| {ref}`Changelog <release-v6-1>` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.1.0/sbom-desktop-v6.1.0.json) | Released: 2026-02-16<br/>Support Ends: 2026-05-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}`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.4) \| {ref}`Changelog <release-v5-13>` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v5.13.4/sbom-desktop-v5.13.4.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>` |
| v5.12 [Download](https://github.com/mattermost/desktop/releases/tag/v5.12.1) \| {ref}`Changelog <release-v5-12>` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v5.12.1/sbom-desktop-v5.12.1.json) | Released: 2025-05-16<br/>Support Ends: 2025-08-15 | {ref}`v10.10 <release-v10.10-feature-release>`, {ref}`v10.9 <release-v10.9-feature-release>`, {ref}`v10.8 <release-v10.8-feature-release>`, {ref}`v10.7 <release-v10.7-feature-release>`, {ref}`v10.6 <release-v10.6-feature-release>`, {ref}`v10.5 <release-v10.5-extended-support-release>` |
Expand Down