240db4e2a7
Some checks failed
Server CI / Postgres (shard 0) (push) Has been skipped
Server CI / Postgres (shard 3) (push) Has been skipped
BuildEnv Docker Image / build-image (push) Failing after 4s
BuildEnv Docker Image / build-image-fips (push) Failing after 4s
Migration Review & Release Notes / Generate migration review & release notes (push) Failing after 3s
Server CI / Build Environment (push) Failing after 3s
Server CI / Postgres (shard 1) (push) Has been skipped
Tools CI / check-style (mattermost-govet) (push) Failing after 4s
Server CI / Postgres (shard 2) (push) Has been skipped
Tools CI / check-style (mmgotool) (push) Failing after 3s
Server CI / Elasticsearch v8 Compatibility (push) Has been skipped
Server CI / OpenSearch v2 Compatibility (push) Has been skipped
Server CI / Postgres FIPS (shard 0) (push) Has been skipped
Tools CI / Test (mattermost-govet) (push) Failing after 3s
Server CI / Postgres FIPS (shard 1) (push) Has been skipped
Server CI / Postgres FIPS (shard 2) (push) Has been skipped
Tools CI / Test (mmgotool) (push) Failing after 3s
Server CI / Postgres FIPS (shard 3) (push) Has been skipped
Server CI / Run mmctl tests (push) Has been skipped
Server CI / Run mmctl tests (FIPS) (push) Has been skipped
Server CI / Merge Postgres Test Results (push) Has been skipped
Server CI / Merge Postgres FIPS Test Results (push) Has been skipped
Server CI / Check backport migrations (push) Has been skipped
Server CI / Check generated files (push) Has been skipped
Server CI / check-style (push) Has been skipped
Server CI / Vet API (push) Has been skipped
Server CI / Build mattermost server app (push) Has been skipped
Server CI / Server CI Complete (push) Failing after 2s
Server CI / Server CI Artifacts (push) Has been skipped
Server CI / Sentry Upload (push) Has been skipped
Server CI / Server CI Report (push) Failing after 5m1s
Server CI Nightly Race / Race Detector (push) Has been skipped
CodeQL / Analyze (go) (push) Has been cancelled
CodeQL / Analyze (javascript) (push) Has been cancelled
Webapp CI Cache Warm / Warm Webapp node_modules Cache (push) Has been cancelled
E2E CI Cache Warm / Warm E2E npm Registry Cache (push) Has been cancelled
API / build (push) Has been cancelled
Web App CI / check-types (push) Has been cancelled
Web App CI / check-lint (push) Has been cancelled
Web App CI / check-i18n (push) Has been cancelled
Web App CI / check-external-links (push) Has been cancelled
Web App CI / test (platform) (push) Has been cancelled
Web App CI / test (mattermost-redux) (push) Has been cancelled
Web App CI / test (channels shard 1/4) (push) Has been cancelled
Web App CI / test (channels shard 2/4) (push) Has been cancelled
Web App CI / test (channels shard 3/4) (push) Has been cancelled
Web App CI / test (channels shard 4/4) (push) Has been cancelled
Web App CI / upload-coverage (push) Has been cancelled
Web App CI / build (push) Has been cancelled
YAML Lint / yamllint (push) Has been cancelled
Push mirrored docker images / cd/Push mirrored docker images (push) Has been cancelled
docs-cd / Build and deploy docs (push) Has been cancelled
Docs CI / build (push) Has been cancelled
E2E Cache Warm: Cypress deps / Warm Cypress deps cache (push) Has been cancelled
Scorecards supply-chain security / Scorecard analysis (push) Has been cancelled
Server CI Weekly / Postgres FIPS (push) Has been skipped
Server CI Weekly / Run mmctl tests (FIPS) (push) Has been skipped
Server CI Weekly / Postgres with binary parameters (push) Has been skipped
Server CI Weekly / Build Environment (push) Failing after 1s
Server CI Cache Warm / Warm Go Module and Build Cache (push) Failing after 2s
Server CI Nightly Race / Build Environment (push) Failing after 1s
61 lines
4.0 KiB
Plaintext
61 lines
4.0 KiB
Plaintext
---
|
|
title: "Install the Mattermost desktop app"
|
|
---
|
|
<PlanAvailability slug="all-commercial" />
|
|
|
|
Download and install the Mattermost desktop app [for macOS from the App Store](https://apps.apple.com/us/app/mattermost-desktop/id1614666244?mt=12), [for Windows from the Microsoft Store](https://apps.microsoft.com/detail/xp8br8mh3lpklt?hl=en-US&gl=US), or by [using a package manager (Linux)](/deployment-guide/desktop/linux-desktop-install).
|
|
|
|
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](/end-user-guide/preferences/connect-multiple-workspaces) 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)](#single-sign-on-sso) section below for details on the external providers that Mattermosts supports.
|
|
|
|
</Note>
|
|
|
|
## Upgrade the desktop app
|
|
|
|
From v6.1.0, Mattermost Desktop uses in-app notifications to alert you when new releases are available. You'll see a notification in the **Downloads** dropdown with platform-specific options:
|
|
|
|
- **macOS (App Store)**: Select **Open Mac App Store** to update through the App Store.
|
|
- **macOS (DMG)**: Select **Download Update** to download the new DMG file from your browser. Open the DMG and drag Mattermost to your Applications folder.
|
|
- **Windows (Microsoft Store)**: Select **Use Windows Store** to update through the Microsoft Store.
|
|
- **Windows (MSI)**: Select **Download Manually** to download the MSI installer from your browser, then run the installer.
|
|
- **Linux**: Select the notification to open the GitHub releases page, download the appropriate package for your system (AppImage, deb, rpm, Flatpak), and install it.
|
|
|
|
**Manual update check**
|
|
|
|
You can manually check for updates at any time by:
|
|
|
|
- Selecting **Help \> Check for Updates** from the menu bar, or
|
|
- Going to **Settings \> Updates** and selecting **Check Now**
|
|
|
|
**Skip a version**
|
|
|
|
If you don't want to see notifications for a specific version, select **Skip This Version** in the notification. You won't see notifications for that version, but you'll be notified when a newer version is released.
|
|
|
|
<Note>
|
|
|
|
In enterprise deployments, your system administrator may disable update notifications via Group Policy. If you're not seeing update notifications, contact your IT department.
|
|
|
|
</Note>
|
|
|
|
### Upgrading to v6.1.0 using Windows MSI installer
|
|
|
|
If you're upgrading from a version earlier than v6.1.0 using the Windows MSI installer, you may need to recreate your taskbar shortcut once after upgrading. This one-time change improves shortcut reliability and prevents shortcuts from breaking during future upgrades.
|
|
|
|
Prior to v6.1.0, installing over an older Desktop App version could break shortcuts. The v6.1.0 MSI installer uses a more reliable method for shortcut icons that prevents this issue in future upgrades. This only affects Windows MSI installer upgrades. The Windows Store version is not affected, and future upgrades to v6.1.1 and later won't require shortcut recreation.
|
|
|
|
If your taskbar shortcut shows the wrong icon or fails to launch after upgrading to v6.1.0:
|
|
|
|
1. Right-click the broken shortcut on your taskbar and select **Unpin from taskbar**.
|
|
2. Launch Mattermost Desktop from the Start Menu or desktop shortcut.
|
|
3. Right-click the Mattermost icon in the taskbar while it's running.
|
|
4. Select **Pin to taskbar**.
|
|
|
|
Your new shortcut will work correctly for all future updates.
|