Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

v5.11 Desktop changelog #7702

Open
wants to merge 15 commits into
base: master
Choose a base branch
from
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
72 changes: 72 additions & 0 deletions source/about/desktop-app-changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,78 @@

This changelog summarizes updates to Mattermost desktop app releases for [Mattermost](https://mattermost.com).

(release-v5-11)=
## Release v5.11 (Extended Support Release)

**Release day: February 14th, 2025**

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

```{Note}
Mattermost Desktop App v5.11.0 contains a low severity level security fix. Upgrading is highly 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/).
```

### Compatibility

- Desktop App is supported on any currently supported [Mattermost server version](https://docs.mattermost.com/about/mattermost-desktop-releases.html#latest-releases).
- Updated Chromium minimum supported version to 132+.

### Improvements

#### Linux

- Modified rpm-digest to utilize sha256 instead of md5 to all for rpm installation on FIPS mode enabled Enterprise Linux systems.

#### All Platforms

- Added two menu items to help users forcibly clear out cache and session data.
- Improved the help options in the **Help** menu.
- Updated the styling of the **Downloads** menu to improve text fitting and to prevent text overlap.
- Refreshed loading and welcome screens.
- Server URLs are now auto-filled when deep-linking into the Desktop App if the server isn't configured.
- Removed legacy code for older unsupported Mattermost servers.
- Calls: while the popout window is open, the widget window's visibility will change so that it is not always on top of other windows.

### Architectural Changes

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

### Bug Fixes

#### macOS

- Fixed an issue where the MAS migration from DMG would always fail, fixed a potential crash case.

#### Windows

- Fixed an issue with per-server permission checks for GPO-configured servers on Windows.
- Fixed an issue where the app could crash loading a thumbnail on Windows.

#### Linux

- Fixed an issue for Linux users where the app could crash when trying to add the first server.

#### All Platforms

- Fixed an issue where autocompleting did not stop while the user was typing `https://`.
- Fixed an issue preventing the screen sharing selection modal to show when the app was focused on a different tab (e.g. Playbooks, Boards).
- Fixed an issue trying to download images using right-click > **Save As...**.
- Fixed an issue where the URL view would trap focus when tabbing over a link.

### Known Issues

- Boards is not using the new Desktop API, causing issues in v5.11+ [MM-61745](https://mattermost.atlassian.net/browse/MM-61745). Users of v5.11 will need to upgrade their Boards plugin version to v9.1.0+ avoid the issue.
- 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 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.
- On apps using GPO configurations, when adding a second server tab, it's possible to drag and drop tabs, but they'll jump back to the original position when releasing the mouse.

### Contributors

- [andr-sokolov](https://github.com/andr-sokolov), [devinbinnie](https://github.com/devinbinnie), [jonathan-dove](https://github.com/jonathan-dove), [pvev](https://github.com/pvev), [s1Sharp](https://github.com/s1Sharp), [streamer45](https://github.com/streamer45).

(release-v5-10)=
## Release v5.10

Expand Down
5 changes: 3 additions & 2 deletions source/about/mattermost-desktop-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
```

```{Important}
Support for Mattermost Server v9.5 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) has come to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is required.
Support for Mattermost Server v9.11 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) is coming to the end of its life cycle on May 15, 2025. Upgrading to Mattermost Server v10.5 or later is recommended.
```

## Frequency
Expand All @@ -21,7 +21,8 @@ Mattermost releases a new desktop app version every 4 months, in February, May,

| **Release** | **Released on** | **Support ends** | **Compatible with** |
|:---|:---|:---|:---|
| v5.10 [Download](https://github.com/mattermost/desktop/releases/tag/v5.10.2) \| {ref}`Changelog <release-v5-10>` | 2024-11-15 | 2025-02-15 | {ref}`v10.2 <release-v10.2-feature-release>`, {ref}`v10.1 <release-v10.1-feature-release>`, {ref}`v10.0 <release-v10.0-major-release>`, {ref}`v9.11 <release-v9-11-extended-support-release>`, {ref}`v9.5 <release-v9-5-extended-support-release>` |
| v5.11 [Download](https://github.com/mattermost/desktop/releases/tag/v5.11.0) \| {ref}`Changelog <release-v5-11>` | 2025-02-14 | 2025-11-15 | {ref}`v10.5 <release-v10.5-extended-support-release>`, {ref}`v10.4 <release-v10.4-feature-release>`, {ref}`v10.3 <release-v10.3-feature-release>`, {ref}`v9.11 <release-v9-11-extended-support-release>` |
| v5.10 [Download](https://github.com/mattermost/desktop/releases/tag/v5.10.2) \| {ref}`Changelog <release-v5-10>` | 2024-11-15 | 2025-02-13 | {ref}`v10.2 <release-v10.2-feature-release>`, {ref}`v10.1 <release-v10.1-feature-release>`, {ref}`v10.0 <release-v10.0-major-release>`, {ref}`v9.11 <release-v9-11-extended-support-release>`, {ref}`v9.5 <release-v9-5-extended-support-release>` |
| v5.9 [Download](https://github.com/mattermost/desktop/releases/tag/v5.9.2) \| {ref}`Changelog <release-v5-9>` | 2024-08-16 | 2025-05-15 | {ref}`v9.11 <release-v9-11-extended-support-release>`, {ref}`v9.10 <release-v9-10-feature-release>`, {ref}`v9.9 <release-v9-9-feature-release>`, {ref}`v9.8 <release-v9-8-feature-release>`, {ref}`v9.5 <release-v9-5-extended-support-release>` |
| v5.8 [Download](https://github.com/mattermost/desktop/releases/tag/v5.8.0) \| {ref}`Changelog <release-v5-8>` | 2024-05-16 | 2024-08-15 | {ref}`v9.9 <release-v9-9-feature-release>`, {ref}`v9.8 <release-v9-8-feature-release>`, {ref}`v9.7 <release-v9-7-feature-release>`, {ref}`v9.6 <release-v9-6-feature-release>`, {ref}`v9.5 <release-v9-5-extended-support-release>`, {ref}`v8.1 <release-v8-1-extended-support-release>` |
| v5.7 [Download](https://github.com/mattermost/desktop/releases/tag/v5.7.0) \| {ref}`Changelog <release-v5-7>` | 2024-03-15 | 2024-05-15 | {ref}`v9.6 <release-v9-6-feature-release>` |
Expand Down
16 changes: 8 additions & 8 deletions source/collaborate/install-desktop-app.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,8 @@ You can download the `desktop app <https://mattermost.com/apps/>`_ directly from

**Install the Mattermost Desktop App**

1. Download the latest version of the Mattermost desktop app for the `64-bit version of Windows <https://releases.mattermost.com/desktop/5.10.2/mattermost-desktop-5.10.2-win-x64.msi>`_
2. From the **\Downloads** folder, right-click on the file ``mattermost-desktop-setup-5.10.2-win.exe``, then select **Open** to start an installer for the app. Once finished, the Mattermost desktop app opens automatically.
1. Download the latest version of the Mattermost desktop app for the `64-bit version of Windows <https://releases.mattermost.com/desktop/5.11.0/mattermost-desktop-5.11.0-win-x64.msi>`_
2. From the **\Downloads** folder, right-click on the file ``mattermost-desktop-setup-5.11.0-win.exe``, then select **Open** to start an installer for the app. Once finished, the Mattermost desktop app opens automatically.

.. warning::
Mattermost Desktop should always be installed on a local drive. Network Shares are not supported as installation locations.
Expand Down Expand Up @@ -64,8 +64,8 @@ You can download the `desktop app <https://mattermost.com/apps/>`_ directly from

1. Download the latest version of the Mattermost desktop app:

- `Intel systems <https://releases.mattermost.com/desktop/5.10.2/mattermost-desktop-5.10.2-mac-x64.dmg>`_
- `M1 systems <https://releases.mattermost.com/desktop/5.10.2/mattermost-desktop-5.10.2-mac-m1.dmg>`_ (Beta)
- `Intel systems <https://releases.mattermost.com/desktop/5.11.0/mattermost-desktop-5.11.0-mac-x64.dmg>`_
- `M1 systems <https://releases.mattermost.com/desktop/5.11.0/mattermost-desktop-5.11.0-mac-m1.dmg>`_ (Beta)

2. Double-click the download to open the disk image.

Expand Down Expand Up @@ -121,21 +121,21 @@ You can download the `desktop app <https://mattermost.com/apps/>`_ directly from

**Install the Mattermost Desktop App**

1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-5.10.2-linux-x86_64.rpm <https://releases.mattermost.com/desktop/5.10.2/mattermost-desktop-5.10.2-linux-x86_64.rpm>`_
1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-5.11.0-linux-x86_64.rpm <https://releases.mattermost.com/desktop/5.11.0/mattermost-desktop-5.11.0-linux-x86_64.rpm>`_

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

.. code-block:: sh

sudo rpm -i mattermost-desktop-5.10.2-linux-x86_64.rpm
sudo rpm -i mattermost-desktop-5.11.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-5.10.2-linux-x86_64.rpm
sudo rpm -u mattermost-desktop-5.11.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 @@ -148,7 +148,7 @@ You can download the `desktop app <https://mattermost.com/apps/>`_ directly from

**Install the Desktop App's compressed tarball**

1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-5.10.2-linux-x64.tar.gz <https://releases.mattermost.com/desktop/5.10.2/mattermost-desktop-5.10.2-linux-x64.tar.gz>`_
1. Download the latest version of the Mattermost desktop app for 64-bit systems: `mattermost-desktop-5.11.0-linux-x64.tar.gz <https://releases.mattermost.com/desktop/5.11.0/mattermost-desktop-5.11.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
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Desktop MSI installer and group policy installation guides
.. include:: ../_static/badges/allplans-selfhosted.rst
:start-after: :nosearch:

This guide provides steps to install the 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/v5.10.2>`_.
This guide provides steps to install the 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/v5.11.0>`_.

Download group policy and MSI installer files
----------------------------------------------
Expand All @@ -19,22 +19,22 @@ 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 v5.10.2 <https://github.com/mattermost/desktop/releases/tag/v5.10.2>`__ and download the appropriate installer for your version of Windows (32-bit vs. 64-bit).
3. Navigate to the release page for `version v5.11.0 <https://github.com/mattermost/desktop/releases/tag/v5.11.0>`__ 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/v5.10.2.zip>`__ file as well to extract group policy files.
4. Download the `source.zip <https://github.com/mattermost/desktop/archive/v5.11.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.

Install group policy files locally
-----------------------------------

1. Browse to the folder the above files were downloaded to and unzip the ``desktop-5.10.2.zip`` file in place.
1. Browse to the folder the above files were downloaded to and unzip the ``desktop-5.11.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-5.10.2\resources\windows\gpo`` folder and copy the contents.
2. Navigate to the unzipped ``desktop-5.11.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 @@ -146,7 +146,7 @@ Perform a silent installation of the MSI by running the following command:

Perform a silent installation of MSI by running the following command:

``msiexec /i mattermost-desktop-v5.10.2-x64.msi /qn``
``msiexec /i mattermost-desktop-v5.11.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.
Expand All @@ -159,17 +159,17 @@ Install for all users

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

``msiexec /i mattermost-desktop-v5.10.2-x64.msi ALLUSERS=1``
``msiexec /i mattermost-desktop-v5.11.0-x64.msi ALLUSERS=1``

.. note::
- Installing the MSI for all users :ref:`disables automatic updates <collaborate/install-desktop-app:install and update the mattermost desktop app>` for the desktop app on Windows.
- To :ref:`disable automatic updates <collaborate/install-desktop-app:install and update the mattermost desktop app>` on a per-user basis, use the ``DISABLEAUTOUPDATE`` parameter: ``msiexec /i mattermost-desktop-v5.10.2-x64.msi DISABLEAUTOUPDATE=1``
- To :ref:`disable automatic updates <collaborate/install-desktop-app:install and update the mattermost desktop app>` on a per-user basis, use the ``DISABLEAUTOUPDATE`` parameter: ``msiexec /i mattermost-desktop-v5.11.0-x64.msi DISABLEAUTOUPDATE=1``

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

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

``msiexec /i mattermost-desktop-v5.10.2-x64.msi APPLICATIONFOLDER=<install directory>``
``msiexec /i mattermost-desktop-v5.11.0-x64.msi APPLICATIONFOLDER=<install directory>``

Change this command as new versions of the Mattermost Desktop App are released.
8 changes: 4 additions & 4 deletions source/install/software-hardware-requirements.rst
Original file line number Diff line number Diff line change
Expand Up @@ -45,10 +45,10 @@ PC web
.. csv-table::
:header: "Browser", "Self-Hosted Technical Requirement", "Cloud Technical Requirement"

"Chrome", "v130+", "v130+"
"Chrome", "v132+", "v132+"
"Firefox", "v115+", "v115+"
"Safari", "v17+", "v17+"
"Edge", "v130+", "v130+"
"Edge", "v132+", "v132+"

`*` 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 @@ -72,8 +72,8 @@ Mobile web
.. csv-table::
:header: "Browser", "Technical Requirement"

"iOS", "iOS 13.4+ with Safari 17+ or Chrome 130+"
"Android", "Android 7+ with Chrome 130+"
"iOS", "iOS 13.4+ with Safari 17+ or Chrome 132+"
"Android", "Android 7+ with Chrome 132+"

Email client
^^^^^^^^^^^^
Expand Down