Skip to content
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.2.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.3.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.

4. Download the `source.zip <https://github.com/mattermost/desktop/archive/v6.2.2.zip>`__ file as well to extract group policy files.
4. Download the `source.zip <https://github.com/mattermost/desktop/archive/v6.3.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.2.2.zip`` file in place.
1. Browse to the folder the above files were downloaded to and unzip the ``desktop-6.3.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.2.2\resources\windows\gpo`` folder and copy the contents.
2. Navigate to the unzipped ``desktop-6.3.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.2.2-x64.msi /qn``
**Command Prompt:** ``msiexec /i mattermost-desktop-v6.3.0-x64.msi /qn``

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

.. note::
- Replace ``<version>`` with the actual version number (e.g., ``v6.2.2``).
- Replace ``<version>`` with the actual version number (e.g., ``v6.3.0``).
- From v6.1.0, the MSI installs per-machine by default, requiring administrator privileges.
Comment thread
amyblais marked this conversation as resolved.

From version v5.9.0 of the Mattermost desktop app, the following silent MSI installation options are also available.
Expand All @@ -225,8 +225,8 @@ Specify an install directory

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

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

Change this command as new versions of the Mattermost Desktop App are released.

Expand Down
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.2.2-linux-x86_64.rpm <https://releases.mattermost.com/desktop/6.2.2/mattermost-desktop-6.2.2-linux-x86_64.rpm>`_
1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-6.3.0-linux-x86_64.rpm <https://releases.mattermost.com/desktop/6.3.0/mattermost-desktop-6.3.0-linux-x86_64.rpm>`_

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

.. code-block:: sh

sudo rpm -i mattermost-desktop-6.2.2-linux-x86_64.rpm
sudo rpm -i mattermost-desktop-6.3.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.2.2-linux-x86_64.rpm
sudo rpm -u mattermost-desktop-6.3.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.2.2``) and ``{ARCH}`` with your architecture (``x86_64`` or ``aarch64``).
Replace ``{VERSION}`` with the version number (e.g., ``6.3.0``) and ``{ARCH}`` with your architecture (``x86_64`` or ``aarch64``).
Comment thread
amyblais marked this conversation as resolved.

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.2.2-linux-x64.tar.gz <https://releases.mattermost.com/desktop/6.2.2/mattermost-desktop-6.2.2-linux-x64.tar.gz>`_
1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-6.3.0-linux-x64.tar.gz <https://releases.mattermost.com/desktop/6.3.0/mattermost-desktop-6.3.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", "v146+", "v146+"
"Chrome", "v150+", "v150+"
"Firefox", "v140+", "v140+"
"Safari", "v26.2+", "v26.2+"
"Edge", "v146+", "v146+"
"Edge", "v150+", "v150+"

`*` 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 146+"
"Android", "Android 7+ with Chrome 146+"
"iOS", "iOS 16.0+ with Safari 26.2+ or Chrome 150+"
"Android", "Android 7+ with Chrome 150+"

Email client
^^^^^^^^^^^^
Expand Down
52 changes: 52 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,58 @@ This changelog summarizes updates to Mattermost desktop app releases for [Matter
```{include} common-esr-support.md
```

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

**v6.3.0 Release Day: 2026-08-14**

**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).
- Updated Chromium minimum supported version to 150+.

### Improvements

#### All Platforms

- Added koffi native module, and added connectors for macOS and Windows native session attributes.
- Added support for explicitly trusted embedded media origins for media permission requests.
- Updated onboarding and server connection welcome messaging.
- Added an advanced setting to enable or disable session attributes. Some resources may be inaccessible when disabled.
- Enabled client-collected **Session Attributes** to be sent to enabled servers.
- Added ``F12`` to open **Developer Tools** for current tab.

### Architectural Changes

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

### Bug Fixes

#### macOS
- Fixed an issue where a ``mattermost://`` deep link could open the **Add Server** dialog.

#### Linux
- Fixed download URL construction in "Download Options" for Linux releases.
- Fixed the association to the desktop launcher and the wrong icon being shown in Ubuntu.

#### All Platforms

- Fixed an issue where other views could end an active call.
- Fixed a rare crash where closing a server tab or window while it was still loading could throw "Object has been destroyed" in the main process.

### Open Source Components

- Added ``joi`` and ``fast-xml-parser`` to https://github.com/mattermost/desktop/.
Comment thread
amyblais marked this conversation as resolved.

### 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.
- 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.
- 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-2)=
## Release v6.2 (Extended Support Release)

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.3 [Download](https://github.com/mattermost/desktop/releases/tag/v6.3.0) \| {ref}`Changelog <release-v6-3>` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.3.0/sbom-desktop-v6.3.0.json) | Released: 2026-08-14<br/>Support Ends: 2026-11-15 | {ref}`v11.10 <release-v11.10-feature-release>`, {ref}`v11.9 <release-v11.9-feature-release>`, {ref}`v11.8 <release-v11.8-feature-release>`, {ref}`v11.7 <release-v11.7-extended-support-release>` |
| v6.2 [Download](https://github.com/mattermost/desktop/releases/tag/v6.2.2) \| {ref}`Changelog <release-v6-2>` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.2.2/sbom-desktop-v6.2.2.json) | Released: 2026-05-15<br/>Support Ends: 2027-05-15 {ref}`EXTENDED <release-types>` | {ref}`v11.9 <release-v11.9-feature-release>`, {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>` |
| 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>` |
Expand Down
Loading