Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
60 changes: 60 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,66 @@ 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

#### 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.
- Fixed an issue where the **Settings** modal could not be opened when no servers were configured.

### 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.5) \| {ref}`Changelog <release-v5-13>` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v5.13.5/sbom-desktop-v5.13.5.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