docs/main/product-overview/desktop-app-changelog.mdx
import Inc0_common_esr_support from './common-esr-support.mdx';
This changelog summarizes updates to Mattermost desktop app releases for Mattermost.
<Inc0_common_esr_support />
v6.2.2, released 2026-06-23
v6.2.1, released 2026-06-17
v6.2.0, released 2026-05-15
Download Binaries: Mattermost Desktop on GitHub
cf-prefs to https://github.com/mattermost/desktop.Warning 1946. Property 'System.AppUserModel.ID' for shortcut 'Mattermost.Ink' could not be set. This message can be safely ignored./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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.v6.1.2, released 2026-04-21
v6.1.1, released 2026-04-08
v6.1.0, released 2026-03-02
Download Binaries: Mattermost Desktop on GitHub
m1 to arm64.@sentry/electron and removed electron-updater from https://github.com/mattermost/desktop.Warning 1946. Property 'System.AppUserModel.ID' for shortcut 'Mattermost.Ink' could not be set. This message can be safely ignored./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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.v6.0.4, released 2026-01-20
v6.0.3, released 2026-01-16
v6.0.2, released 2025-12-10
v6.0.1, released 2025-11-18
v6.0.0, released 2025-11-14
Download Binaries: Mattermost Desktop on GitHub
<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 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>registry-js native module for Windows registry reading in https://github.com/mattermost/desktop/.Warning 1946. Property 'System.AppUserModel.ID' for shortcut 'Mattermost.Ink' could not be set. This message can be safely ignored./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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.v5.13.7, released 2026-06-17
v5.13.6, released 2026-05-13
v5.13.5, released 2026-03-24
v5.13.4, released 2026-01-29
v5.13.3, released 2026-01-22
v5.13.2, released 2025-10-16
v5.13.1, released 2025-09-10
v5.13.0, released 2025-08-15
Download Binaries: Mattermost Desktop on GitHub
mattermost:// protocol handling to open in-app links within the desktop application instead of external protocol dialogs.electron-devtools-installer and registry-js, and removed electron-connect and electron-extension-installer from https://github.com/mattermost/desktop/.Warning 1946. Property 'System.AppUserModel.ID' for shortcut 'Mattermost.Ink' could not be set. This message can be safely ignored./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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.v5.12.1, released 2025-05-31
v5.12.0, released 2025-05-16
Download Binaries: Mattermost Desktop on GitHub
<Note>Mattermost Desktop App v5.12.0 contains a medium severity level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>@floating-ui/react to https://github.com/mattermost/desktop.Warning 1946. Property 'System.AppUserModel.ID' for shortcut 'Mattermost.Ink' could not be set. This message can be safely ignored./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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.v5.11.3, released 2025-05-23
v5.11.2, released 2025-03-12
v5.11.1, released 2025-03-01
v5.11.0, released 2025-02-14
Download Binaries: Mattermost Desktop on GitHub
<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 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>https://.Warning 1946. Property 'System.AppUserModel.ID' for shortcut 'Mattermost.Ink' could not be set. This message can be safely ignored./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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.v5.10.2, released 2024-12-17
v5.10.1, released 2024-11-20
v5.10.0, released 2024-11-15
Download Binaries: Mattermost Desktop on GitHub
<Note>Mattermost Desktop App v5.10.0 contains a low severity level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>titleBarOverlay for Windows instead of the buttons that were baked-in to the app.performanceMonitor to collect and send anonymous usage data to server dashboards.about:blank popup windows using window.open().desktopAPI.getDesktopSources call.Developer Mode settings to help debug performance issues.electron-log and turned on async logging.currentServerId wasn't set.@emotion/react to https://github.com/mattermost/desktop.Warning 1946. Property 'System.AppUserModel.ID' for shortcut 'Mattermost.Ink' could not be set. This message can be safely ignored./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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.v5.9.2, released 2024-12-17
v5.9.1, released 2024-11-20
v5.9.0, released 2024-08-16
Download Binaries: Mattermost Desktop on GitHub
<Note>Mattermost v5.9.0 contains low to medium severity level security fixes. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note> <Note>v5.9.0 is the first Extended Support Release for the Desktop App. See more details in this documentation.
</Note>BrowserView not to resize.@aws-sdk/client-s3, @aws-sdk/lib-storage, @electron/rebuild, axios, chai, electron-mocha, mochawesome, nan, node-abi, node-gyp, playwright, ps-node, recursive-readdir and robotjs from https://github.com/mattermost/desktop.Warning 1946. Property 'System.AppUserModel.ID' for shortcut 'Mattermost.Ink' could not be set. This message can be safely ignored./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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.v5.8.1, released 2024-06-13
v5.8.0, released 2024-05-16
Download Binaries: Mattermost Desktop on GitHub
<Note>Mattermost v5.8.0 contains low to medium severity level security fixes. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>--inspect tag./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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.Release Date: March 15, 2024
Download Binaries: Mattermost Desktop on GitHub
@aws-sdk/client-s3, @aws-sdk/lib-storage and @mattermost/desktop-api, and removed aws-sdk from https://github.com/mattermost/desktop./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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.Release Date: December 15, 2023
Download Binaries: Mattermost Desktop on GitHub
gconf dependency for Debian/Ubuntu.media permission.electron-extension-installer and node-gyp to https://github.com/mattermost/desktop./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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.v5.5.1, released 2023-10-03
CVE-2023-4863 of the third-party library libwebp.info level.v5.5.0, released 2023-09-15
Download Binaries: Mattermost Desktop on GitHub
<Note>Mattermost v5.5.0 contains a medium severity level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>/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).libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.Release Day: June 19, 2023
Download Binaries: Mattermost Desktop on GitHub
ExtraBar dark when using dark mode.XDG_DOWNLOAD_DIR where it was set./Users/<username>/Library/Containers/Mattermost/Data/Library/Application Support/Mattermost and for Windows it is located in Users/<username>/AppData/Roaming/Mattermost.libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.Download Binaries: Mattermost Desktop on GitHub
v5.3.1, released 2023-04-04
v5.3.0, released 2023-03-30
Mattermost v5.3.0 contains a medium severity level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>/call start slash command./Users/<username>/Library/Containers/Mattermost/Data/Library/Application Support/Mattermost and for Windows it is located in Users/<username>/AppData/Roaming/Mattermost.libnotifyapp library. A recommended workaround is to disable the Mattermost system tray icon via Desktop Settings.Download Binaries: Mattermost Desktop on GitHub
v5.2.2, released 2022-12-06
AppImageLauncher still created a bad shortcut that caused the app not to launch.v5.2.1, released 2022-11-15
.exe installers where the onboarding screen was still displayed even when there was a preconfigured server list.v5.2.0, released 2022-10-31
CTRL/CMD+SHIFT+= is pressed.notifications.flashWindow default value was changed to 0 for Linux.--version or -v command-line flags were passed.macos-notification-state, windows-focus-assist, and react-intl to https://github.com/mattermost/desktop./Users/<username>/Library/Containers/Mattermost/Data/Library/Application Support/Mattermost and for Windows it is located in Users/<username>/AppData/Roaming/Mattermost.libnotifyapp library. A recommended workaround is to disable the system tray icon in the Desktop settings.Download Binaries: Mattermost Desktop on GitHub
v5.1.1, released 2022-06-27
hideOnStart setting didn't work.v5.1.0, released 2022-05-16
Mattermost v5.1.0 contains a low severity level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>X.false by default.ctrl+= and cmd+= to zoom in to match the behavior of Chrome and Firefox.Tab to Server to reflect recent changes in the user interface.Shift+Alt moved the focus to the top menu.libnotifyapp library. A recommended workaround is to disable the system tray icon in the Desktop settings.Download Binaries: Mattermost Desktop on GitHub
v5.0.4, release 2022-02-04
v5.0.3, released 2022-02-01
v5.0.2, released 2021-11-15
v5.0.1, released 2021-10-22
v5.0.0, released 2021-10-13
Original v5.0.0 release
Mattermost v5.0.0 contains a low level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>Ctrl+# is used for changing tabs and Ctrl+Shft+# is used for changing servers.react-beautiful-dnd instead of react-smooth-dnd for a cleaner experience.Alt+<somekey> could cause the menu bar to disable and overlap the top bar on Linux.jira connect modal.libnotifyapp library. A recommended workaround is to disable the system tray icon in the Desktop settings.$ chmod 4755 <installpath>/chrome-sandbox.Download Binaries: Mattermost Desktop on GitHub
v4.7.2, released 2021-09-13
v4.7.1, released 2021-08-03
Mattermost v4.7.1 contains a medium level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
v4.7.0, released 2021-06-23
Mattermost v4.7.0 contains low to medium level security fixes. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>libappnotify1 as a dependency requirement in Debian installers as it's no longer shipped in Debian's Bullseye. It's still recommended to install where available.jira connect modal.create_desktop_file.sh script is removed from the .tar.gz release. As a workaround, it can be downloaded from GitHub here.libnotifyapp library. A recommended workaround is to disable the system tray icon in the Desktop settings.$ chmod 4755 <installpath>/chrome-sandbox.Download Binaries: Mattermost Desktop on GitHub
v4.6.2, released 2021-01-25
gitlab.com did not work on the Desktop App.v4.6.1, released 2020-10-26
v4.6.0, released 2020-10-16
Show Mattermost icon in the menu bar setting is now enabled by default for new installs on Mac, and Show icon in the notification area and Leave app running in the notification area when application window is closed settings are are now enabled by default for new installs on Ubuntu.--hidden was removed. This setting is not respected when AppImage file (Unofficial) is used.libnotifyapp library and a recommended workaround is to disable the system tray icon in the Desktop settings.$ chmod 4755 <installpath>/chrome-sandbox.Many thanks to all our contributors. In alphabetical order:
Download Binaries: Mattermost Desktop on GitHub
v4.5.4, released 2020-09-11
v4.5.3, released 2020-08-25
v4.5.2, released 2020-07-20
v4.5.1, released 2020-07-13
v4.5.0, released 2020-06-16
+ tab to add a new server.True.CMD+Tab keyboard shortcut./.CMD+Tab to navigate away and back to the app.libnotifyapp library and a recommended workaround is to disable the system tray icon in the Desktop settings.$ chmod 4755 <installpath>/chrome-sandbox.Many thanks to all our contributors. In alphabetical order:
Download Binaries: Mattermost Desktop on GitHub
v4.4.2, released 2020-05-11
v4.4.1, released 2020-04-22
v4.4.0, released 2020-02-16
Mattermost v4.4.0 contains low to medium level security fixes. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>libnotifyapp library and a recommended workaround is to disable the system tray icon in the Desktop settings.$ chmod 4755 <installpath>/chrome-sandbox.Many thanks to all our contributors. In alphabetical order:
Download Binaries: Mattermost Desktop on GitHub
v4.3.2, released 2019-11-29
Mattermost v4.3.0 contains a low level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
Fixed an issue where the app started into white screen after a system reboot on Windows.
Fixed an issue where CMD+Z didn't undo on the Mac desktop app.
Fixed an issue where users were unable to zoom in/out except on the first server tab.
Fixed an issue where right-click + "Copy" did not work in some instances.
Fixed an issue where email links in profile popovers didn't work.
v4.3.1, released 2019-10-22
v4.3.0, released 2019-10-17
Mattermost v4.3.0 contains medium level security fixes. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>The Mattermost Desktop v4.3.0 release includes a change to how desktop notifications are sent from non-secure URLs (http://). Organizations using non-secure Mattermost Servers (http://) will need to update to Mattermost Server versions 5.16.0+, 5.15.1, 5.14.4 or 5.9.5 (ESR) to continue receiving desktop notifications when using Mattermost Desktop v4.3.0 or later.
Cmd + Option + Shift + v and Cmd + Shift + v didn't work on macOS desktop app.CMD+Z doesn't undo on the Mac desktop app.Many thanks to all our contributors. In alphabetical order:
This release contains a bug fix for all platforms.
This release contains a bug fix for all platforms.
This release contains a bug fix for all platforms.
Mattermost v4.2.0 contains a high level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
</Note>Ctrl/Cmd+F shortcut to work as browser-like search.electron-builder.json.Many thanks to all our contributors. In alphabetical order:
This release contains a bug fix for all platforms.
This release contains multiple bug fixes for Mac due to an incorrect build for v4.1.0. Windows and Linux apps are not affected.
Each of the issues listed below are already fixed for Windows and Linux v4.1.0.
mattermost:// protocol spawning a new copy of the Desktop App on the taskbar.Release date: May 16, 2018
Improved stability and performance
Updated design for loading animation icon.
Improved appearance of server tabs.
Enabled Certificate Transparency verification in HTTPS.
import and export now replace the require and modul.export modules for better development.en-US locales on initial installation.file:// protocol was not working. Note that localhost URLs are not yet supported.Many thanks to all our contributors. In alphabetical order:
Release date: March 28, 2018
This release contains multiple security updates for Windows, Mac and Linux, and it is highly recommended that users upgrade to this version.
Release date: January 29, 2018
This release contains multiple security updates for Windows, Mac and Linux, and it is highly recommended that users upgrade to this version.
Added a dialog to allow the user to reopen the desktop app if it quits unexpectedly.
Mattermost animation icon is now displayed when loading a page, instead of a blank screen.
Added a dialog to request permissions to show desktop notifications or to use microphone and video for video calls from untrusted origins.
The "Saved" indicator now appears for both Server Management and App Options on the Settings page.
Close button on the Settings page now has a hover effect.
Added new admin configuration settings for:
mattermost:// link if app is already installed.mattermost:// link if app is already installed.Ctrl+Tab and Ctrl+Shift+Tab shortcuts to switch between server tabs.style and CSS.npm run package.rm command to npm, which removes all dynamically generated files to make it easy to reset the app between builds and branches.+ button in the server tab bar.Many thanks to all our contributors. In alphabetical order:
Release date: August 30, 2017
This release contains a security update for Windows, Mac and Linux, and it is highly recommended that users upgrade to this version.
Release date: May 9th, 2017
Many thanks to all our contributors. In alphabetical order:
Thanks also to those who reported bugs that benefited the release, in alphabetical order:
Release date: February 28, 2017
Upgrading to Mattermost server 3.6 or later is recommended, as new features for the desktop app have been added following the release of the team sidebar.
Added support for unread indicators following the release of team sidebar in Mattermost server 3.6
Removed a confusing CTRL/CMD+S shortcut for searching within a Mattermost team
Added support for SAML OneLogin and Google authentication for Enterprise users
Switching to a server from the system tray icon, from "Window" menu bar item, or through CTRL/CMD+{n} shortcut now works while viewing the Settings page
Streamlined desktop server management:
Simplified desktop app options:
Many thanks to all our contributors. In alphabetical order:
Release date: December 14, 2016
certificate.json fileMacintosh HDMany thanks to all our contributors. In alphabetical order:
Thanks also to those who reported bugs that benefited the release, in alphabetical order:
Release date: September 30, 2016
This release contains a security update and it is highly recommended that users upgrade to this version.
Version number updated to 3.4 to make numbering consistent with Mattermost server and mobile app releases. This change will not imply monthly releases.
v3.4.1, released 2016-09-30
(Mac) Fixed an issue where the app window pops up second to foreground when a new message is received
v3.4.0, released 2016-09-22
Current team and channel name shown in window title bar
Team tab is bolded for unread messages and has a red dot with a count of unread mentions
Added new shortcuts:
Upgraded the Settings page user interface
The app now tries to reconnect periodically if a page fails to load
Added validation for name and URL when adding a new team on the Settings page
create_desktop_file.sh to create Mattermost.desktop desktop entry to help integrate the application into a desktop environment more easilyMany thanks to all our contributors. In alphabetical order:
Release date: 2016-07-18
Download the latest version here
New Keyboard Shortcuts
Adjust text size
CTRL+0 (Menu Bar -> View -> Actual Size): Reset the zoom level.
CTRL+PLUS (Menu Bar -> View -> Zoom In): Increase text size
CTRL+MINUS (Menu Bar -> View -> Zoom Out): Decrease text size
Control window
CTRL+W (Menu Bar -> Window -> Close): On Linux, this minimizes the main window.
CTRL+M (Menu Bar -> Window -> Minimize)
Switch teams (these shotcuts also reopen the main window)
CTRL+{1-9} (Menu Bar -> Window -> [Team name]): Open the n-th tab.
CTRL+TAB or ALT+CMD+Right (Menu Bar -> Window -> Select Next Team): Switch to the next window.
CTRL+SHIFT+TAB or ALT+CMD+Left (Menu Bar -> Window -> Select Previous Team): Switch to the previous window.
Right click on the tray item, to see an overview of all your teams. You can also select one and jump right into it.
Added Help to the Menu Bar, which includes
Link to Mattermost Docs
Field to indicate the application version number.
Many thanks to all our contributors. In alphabetical order:
(release-v1-2-1-Beta)=
Release date: 2016-05-24
This release contains a security update and it is highly recommended that users upgrade to this version.
v1.2.1, released 2016-05-24
file://test will open a dialog to confirm the user intended to open a file.v1.2.0, released 2016-05-13
http://.http authentication.http:// and https:// is opened by clicking.Many thanks to all our contributors. In alphabetical order:
(release-v1-1-1-Beta)=
Release date: 2016-04-13
This release contains a security update and it is highly recommended that users upgrade to this version.
v1.1.1, released 2016-04-13
v1.1.0, released 2016-03-30
The electron-mattermost project is now the official desktop application for the Mattermost open source project.
Rename project from electron-mattermost to desktop
Rename the executable file from electron-mattermost to Mattermost
The configuration directory is also different from previous versions.
Should execute following command to take over config.json.
mkdir %APPDATA%\Mattermost and copy %APPDATA%\electron-mattermost\config.json %APPDATA%\Mattermost\config.jsonditto ~/Library/Application\ Support/electron-mattermost/config.json ~/Library/Application\ Support/Mattermost/config.jsonmkdir -p ~/.config/Mattermost && cp ~/.config/electron-mattermost/config.json ~/.config/Mattermost/config.jsonList of releases before the project was promoted as the official desktop application for Mattermost.
Release v1.0.7 (Unofficial) - 2016-02-20
Release v1.0.6 (Unofficial) - 2016-02-16
Release v1.0.5 (Unofficial) - 2016-02-13
Release v1.0.4 (Unofficial) - 2016-02-12
Release v1.0.3 (Unofficial) - 2016-02-03
Release v1.0.2 (Unofficial) - 2016-01-16
Release v1.0.1 (Unofficial) - 2016-01-06
Release v1.0.0 (Unofficial) - 2015-12-27
Release v0.5.1 (Unofficial) - 2015-12-12
Release v0.5.0 (Unofficial) - 2015-12-06
Release v0.4.0 (Unofficial) - 2015-11-03
Release v0.3.0 (Unofficial) - 2015-10-24