Using Mattermost Desktop App¶
Mattermost desktop applications are available for Windows, Mac and Linux operating systems.
You can download the apps directly from our download page and visit our installation guides for help during set up.
To view the latest updates, please see our changelog.
Below are a few tips to get you started and configuring your experience on the desktop app:
Team management¶
You can connect to multiple Mattermost servers from a single interface on the desktop app.
Adding servers and teams¶
To add a new server on the Mattermost instance,
- Click Add new team next to the right of Team Management section.
- Enter Name and a valid URL, which begins with either
http://orhttps://. - Click Add.
You can now access all teams you have joined in the server once you have saved the settings, and each will appear as a separate tab in the app.
You may also add each team separately, if you’d like.
Editing servers and teams¶
To edit a server,
- To the right of the team or server you want update, click Edit.
- Edit Name and/or URL.
- Click Save.
Removing servers and teams¶
To remove a server from your desktop app environment, click on Remove next to the server or a team you want removed.
Settings¶
In addition to Mattermost Account Settings , the desktop app provides additional options to customize your experience.
The Settings Page is available from the File menu under Settings, and can be accessed with CTRL + COMMA on Windows and Linux, and with CMD + COMMA on Mac.
Description of each setting is included below this table.
| Setting | Windows | Mac | Linux |
|---|---|---|---|
| Allow mixed content | Yes | Yes | Yes |
| Show red badge on taskbar icon to indicate unread messages | Yes | Yes | |
| Flash taskbar icon when a new message is received | Yes | Yes | |
| Start app on login | Yes | Yes | |
| Hide menu bar | Yes | Yes | |
| Toggle window visibility when clicking on the tray icon | Yes | ||
| Show icon on menu bar | Yes | Yes | |
| Leave app running in notification center when application window is closed | Yes | Yes |
Allow mixed content¶
If your server is hosted on https://, insecure content, images and scripts with http:// are not rendered by default. This option allows such content to be rendered. If you do enable it, please be mindful of potential security risks shared over http:// protocols.
This setting is on by default.
Note: Enabling mixed content will disable YouTube video previews due to an issue in the underlying technology used by the Mattermost Desktop app.
Show red badge on taskbar icon to indicate unread messages (Windows, Mac only)¶
When enabled, a red badge is shown on the taskbar icon for unread messages with a number count indicating unread mentions. If disabled, a red badge is only shown for unread mentions (with a number count).
This setting is on by default.
Flash taskbar icon when a new message is received (Windows, Linux only)¶
Configure whether the taskbar icon flashes when a new message is received on any of your active teams and servers.
This setting is off by default.
Start app on login (Windows, Linux only)¶
When enabled, Mattermost application starts when you log in to your machine.
This setting is on by default.
Toggle window visibility when clicking on the tray icon (Windows only)¶
When enabled, clicking on the system tray icon allows you to toggle the window open and minimized.
This setting is off by default.
Leave app running in notification center when application window is closed (Mac, Linux only)¶
When enabled, closing the application window will leave the Mattermost desktop app running in your notification center. This can be useful if you’d like to check for unread mentions while away from the app.
This setting is off by default.
Menu Bar¶
The desktop app contains a menu bar with additional features and shortcuts to streamline your experience.
If the menu bar is hidden, you may use the ALT key to display the menu. To have the menu displayed at all times, go to the Settings page and uncheck the Hide menu bar setting.
Below is a list of menu options with the corresponding keyboard shortcuts. For Mac, replace CTRL by CMD unless otherwise specified.
File
- Settings (CTRL + COMMA): Opens app settings where you can manage your servers and configure desktop app settings
- Exit (CTRL + Q): Closes the application. Labeled
Quiton Mac
Edit
- Undo (CTRL + Z): Reverses previous action
- Redo (CTRL + SHIFT + Z; CTRL + Y): Redoes the most recent action
- Cut (CTRL + X): Cuts selected text
- Copy (CTRL + C): Copies selected text
- Paste (CTRL + V): Pastes text from the clipboard
- Select All (CTRL + A): Selects all text in input box
- Search in Team (CTRL + S): Sets focus on the Mattermost search box
View
- Reload (CTRL + R): Reloads the current page
- Clear Cache and Reload (CTRL + SHIFT + R): Clears cached content in application and reloads the current page
- Toggle Full Screen (F11): Toggles the application window full screen mode
- Actual Size (CTRL + 0) - Resets zoom level to default
- Zoom In (CTRL + =; CTRL + SHIFT + =) - Increase font size (zoom in)
- Zoom In (CTRL + MINUS) - Decrease font size (zoom out)
- Toggle Developer Tools (CTRL + SHIFT + I): Toggles sidebar showing developer tools
History
- Back (ALT + Left Arrow; CMD + [ on Mac): Go to previous page in history
- Forward (ALT + Right Arrow; CMD + [ on Mac): Go to next page in history
Window
- Close (CTRL + W) - Closes the application window
- Minimize (CTRL + M) - Minimizes the application window to the taskbar
- Team Name (CTRL + {1-9}) - Opens the n-th tab
- Select Next Team (CTRL + TAB; ALT + CMD + Right Arrow on Mac) - Opens the next tab
- Select Previous Team (CTRL+ SHIFT + TAB; ALT + CMD + Left Arrow on Mac) - Open the previous tab
Help
- Mattermost Docs - Links to Desktop Application’s User Guide .
- Version - Indicates the desktop application version in use
