diff --git a/source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst b/source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst index 776b504cf2d..1268ec0ce9f 100644 --- a/source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst +++ b/source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst @@ -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 `_. +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 `_. .. tip:: @@ -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 `__ 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 `__ and download the appropriate installer for your version of Windows (32-bit vs. 64-bit). -4. Download the `source.zip `__ file as well to extract group policy files. +4. Download the `source.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. @@ -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. @@ -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=""`` -- **PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.0.4-x64.msi APPLICATIONFOLDER=""'`` +- **Command Prompt:** ``msiexec /i mattermost-desktop-v6.1.0-x64.msi APPLICATIONFOLDER=""`` +- **PowerShell:** ``Start-Process -FilePath "$env:systemroot\system32\msiexec.exe" -ArgumentList '/i mattermost-desktop-v6.1.0-x64.msi APPLICATIONFOLDER=""'`` -Change this command as new versions of the Mattermost Desktop App are released. \ No newline at end of file +Change this command as new versions of the Mattermost Desktop App are released. diff --git a/source/deployment-guide/desktop/linux-desktop-install.rst b/source/deployment-guide/desktop/linux-desktop-install.rst index ad40069b78e..e75d9877bc0 100644 --- a/source/deployment-guide/desktop/linux-desktop-install.rst +++ b/source/deployment-guide/desktop/linux-desktop-install.rst @@ -57,13 +57,13 @@ 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 `_ + 1. Download the latest version of the Mattermost desktop app for 64-bit systems: `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. @@ -71,7 +71,7 @@ This page describes how to install the Mattermost desktop app on Linux. .. 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...**. @@ -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 `_ + 1. Download the latest version of the Mattermost desktop app for 64-bit systems: `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`` diff --git a/source/product-overview/deprecated-features.rst b/source/product-overview/deprecated-features.rst index 916aaef4755..98656941ce7 100644 --- a/source/product-overview/deprecated-features.rst +++ b/source/product-overview/deprecated-features.rst @@ -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 `__. - -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 `__. Mattermost Server v11.4 (February 2026) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/source/product-overview/desktop-app-changelog.md b/source/product-overview/desktop-app-changelog.md index 5bb6ad446e2..389718987cb 100644 --- a/source/product-overview/desktop-app-changelog.md +++ b/source/product-overview/desktop-app-changelog.md @@ -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//Library/Containers/Mattermost/Data/Library/Application Support/Mattermost`, for Windows in `Users//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 @@ -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/). diff --git a/source/product-overview/mattermost-desktop-releases.md b/source/product-overview/mattermost-desktop-releases.md index 5ebc12c5b92..37bae454092 100644 --- a/source/product-overview/mattermost-desktop-releases.md +++ b/source/product-overview/mattermost-desktop-releases.md @@ -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 ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.1.0/sbom-desktop-v6.1.0.json) | Released: 2026-02-16
Support Ends: 2026-05-15 | {ref}`v11.4 `, {ref}`v11.3 `, {ref}`v11.2 `, {ref}`v10.11 ` | | v6.0 [Download](https://github.com/mattermost/desktop/releases/tag/v6.0.4) \| {ref}`Changelog ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v6.0.4/sbom-desktop-v6.0.4.json) | Released: 2025-11-14
Support Ends: 2026-03-15 | {ref}`v11.4 `, {ref}`v11.3 `, {ref}`v11.2 `, {ref}`v11.1 `, {ref}`v11.0 `, {ref}`v10.12 `, {ref}`v10.11 ` | | v5.13 [Download](https://github.com/mattermost/desktop/releases/tag/v5.13.4) \| {ref}`Changelog ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v5.13.4/sbom-desktop-v5.13.4.json) | Released: 2025-08-15
Support Ends: 2026-08-15 {ref}`EXTENDED ` | {ref}`v11.0 `, {ref}`v10.12 `, {ref}`v10.11 `, {ref}`v10.10 `, {ref}`v10.9 `, {ref}`v10.5 ` | | v5.12 [Download](https://github.com/mattermost/desktop/releases/tag/v5.12.1) \| {ref}`Changelog ` \| [SBOM download](https://github.com/mattermost/desktop/releases/download/v5.12.1/sbom-desktop-v5.12.1.json) | Released: 2025-05-16
Support Ends: 2025-08-15 | {ref}`v10.10 `, {ref}`v10.9 `, {ref}`v10.8 `, {ref}`v10.7 `, {ref}`v10.6 `, {ref}`v10.5 ` |