Install the Mattermost desktop app#

Download and install the Mattermost desktop app from the App Store (macOS), Microsoft Store (Windows), or by using a package manager (Linux). When new desktop app releases become available, your desktop app is automatically updated.

We strongly recommend installing the desktop app on a local drive. Network shares aren’t supported.

  1. When prompted, enter the Mattermost server link and a display name for the Mattermost instance. The display name is helpful in cases where you connect to multiple Mattermost instances. See the server connections documentation for details.

  2. Enter your user credentials to log into Mattermost.

  3. The team that displays first in the team sidebar opens. If you’re not a member of a team yet, you’re prompted to select a team to join.

Note

When you log into Mattermost using external user credentials, such as Google or Entra ID, you’ll temporarily leave the desktop app during login while authenticating your credentials. Once you’re successfully logged in to Mattermost, you’ll be returned to the desktop app. See the Single Sign-On (SSO) section below for details on the external providers that Mattermosts supports.