Install desktop app on Linux#

This page describes how to install the Mattermost desktop app on Linux.

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.

  1. 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

  1. Install the Mattermost desktop app:

sudo apt install mattermost-desktop

  1. 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.

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

sudo snap install mattermost-desktop --beta

  1. Run Mattermost as a desktop app.

Tip

You can review the current version of your desktop app by selecting the More Use the More icon in the top left corner to access Mattermost desktop apps customization settings. 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

  1. Download the latest version of the Mattermost desktop app for 64-bit systems: mattermost-desktop-5.11.2-linux-x86_64.rpm

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

sudo rpm -i mattermost-desktop-5.11.2-linux-x86_64.rpm

  1. 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 Use the More icon in the top left corner to access Mattermost desktop apps customization settings. 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

  1. Download the latest version of the Mattermost desktop app for 64-bit systems: mattermost-desktop-5.11.2-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

  3. Execute mattermost-desktop located inside the extracted directory.

  4. To create a Desktop launcher, open the file README.md, and follow the instructions in the Desktop launcher section.