Hacktoberfest is here! Contribute, collaborate & earn rewards.
Additional desktop app installations#
This page describes additional ways to install the Mattermost desktop app.
Windows 10+ is required. Automatic app updates are supported and enabled. When a new version of the desktop app is released, your app updates automatically.
Install the Mattermost Desktop App
Download the latest version of the Mattermost desktop app for the 64-bit version of Windows
From the Downloads folder, right-click on the file
mattermost-desktop-setup-5.11.2-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.
MSI Installer and group policies
The following group policies are available supporting a state option of Not Configured, Enabled, or Disabled:
Group policy |
Description |
Mattermost release |
Setting |
|---|---|---|---|
Enable Server Management |
If disabled, management of servers in the app settings are disabled. |
v4.3 or later |
|
Default Server List |
Define one or more default, permanent servers. |
v4.3 or later |
|
Automatic Updates |
If disabled, automatic desktop app updates are disabled. |
v5.1 or later |
|
Disable automatic updates
Automatic desktop app updates can be disabled by configuring the supported group policy. See the MSI installer and group policy documentation for instructions on installing the Mattermost Desktop App via an MSI installer, configuring supported group policies, and performing silent MSI installations. Changes to group policies require you to restart Mattermost for those changes to take effect.
MacOS 11+ is required. You have two ways to install the desktop app, and how you install the app determines whether it updates automatically.
Install from the App Store
We recommend that you install the desktop app from the App Store. When you install through the App Store, your desktop app updates automatically when a new release is available.
Download the Desktop App from GitHub
You can download the desktop app directly from the Downloads page. However, when you install the desktop app this way, you can’t manually check for updates, and updates won’t be installed automatically.
Download the latest version of the Mattermost desktop app:
M1 systems (Beta)
Double-click the download to open the disk image.
Drag the Mattermost application to the Applications folder.
Tip
You can review the current version of your desktop app by selecting Mattermost > About Mattermost from the macOS menu bar.
Both a .deb package (Beta), and an official APT repository is available for Debian 9 and for Ubuntu releases 20.04 LTS or later. Automatic app updates are supported and enabled. When a new version of the desktop app is released, your app updates automatically.
Important
The GPG public key has changed. If you had previously set up the repository on your system, you’ll need to download the new key. You can set the UPDATE_GPG_KEY=yes environment variable when running the setup script to configure it to overwrite the previous key on your system with the new one. The first step of installation then becomes: curl -fsS -o- https://deb.packages.mattermost.com/setup-repo.sh | sudo UPDATE_GPG_KEY=yes bash. Depending on your setup, additional steps may also be required, particularly for installations that don’t rely on the repository setup script.
At the command line, set up the Mattermost repository on your system:
curl -fsS -o- https://deb.packages.mattermost.com/setup-repo.sh | sudo bash
Install the Mattermost desktop app:
sudo apt install mattermost-desktop
Update the Mattermost desktop app:
sudo apt upgrade mattermost-desktop
Snapcraft package
A snap is available for systems that have Snapcraft installed. Snapcraft is installed by default on Ubuntu 16.04 and later, but for most other Linux distributions you can install it manually. To install Snapcraft, see Install snapd on the Snapcraft website for details.
At the command line, execute the following command:
sudo snap install mattermost-desktop --beta
Run Mattermost as a desktop app.
Tip
You can review the current version of your desktop app by selecting the More 
icon located in the top left corner of the desktop app, then selecting Help > Version….
Beta .rpm packages are available for CentOS and RHEL 7 and 8. Automatic app updates aren’t supported. You must update your app manually.
Install the Mattermost Desktop App
Download the latest version of the Mattermost desktop app for 64-bit systems: mattermost-desktop-5.11.2-linux-x86_64.rpm
At the command line, execute the following command:
sudo rpm -i mattermost-desktop-5.11.2-linux-x86_64.rpm
Run Mattermost as a desktop app.
To manually update the desktop app, run the following command:
sudo rpm -u mattermost-desktop-5.11.2-linux-x86_64.rpm
Tip
You can review the current version of your desktop app by selecting the More icon located in the top left corner of the desktop app, then selecting Help > Version….
The Desktop app is available in two formats which are usable on most Linux distributions: a compressed tarball, and an AppImage binary. Both can be downloaded from the Desktop App’s Github releases page. Automatic app updates are supported and enabled on AppImage binary builds. When a new version of the desktop app is released, your app updates automatically.
For instructions on how to use the AppImage binary, please refer to the AppImage Quickstart documentation page.
Install the Desktop App’s compressed tarball
Download the latest version of the Mattermost desktop app for 64-bit systems: mattermost-desktop-5.11.2-linux-x64.tar.gz
Extract the archive to a convenient location, then give
chrome-sandboxin the extracted directory the required ownership and permissions:sudo chown root:root chrome-sandbox && sudo chmod 4755 chrome-sandboxExecute
mattermost-desktoplocated inside the extracted directory.To create a Desktop launcher, open the file
README.md, and follow the instructions in the Desktop launcher section.