Connect to multiple Mattermost workspaces

import useBaseUrl from '@docusaurus/useBaseUrl'; import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

Using the Mattermost desktop or mobile app, you can connect to multiple Mattermost servers from a single interface, and manage system permissions.

Add a server

The Server list is located in the top left corner of the window and displays all servers available. Drag to reorder the servers in the list. You can also navigate the server options using keyboard shortcuts.

If you're using the desktop app prior to release v5.0, individual servers display as separate tabs at the top of the window instead of the top left corner of the window as a list, and servers are managed by going to … > File > Settings on Windows and Mattermost > Preferences on Mac.

1. Select Add a server.

1. Enter the server URL. Server URLs must begin with either http:// or https://.

Tip

Can't find your Mattermost server URL? Ask your company’s IT department or your Mattermost system admin for your organization’s Mattermost Site URL. It’ll look something like https://example.com/company/mattermost, mattermost.yourcompanydomain.com, or chat.yourcompanydomain.com. These URLs could also end in .net.

1. Enter the server's Display Name.
2. [Desktop only] If your server requires an authentication secret, you'll be prompted to enter it when you connect. Enter the secret provided by your administrator and select OK.
3. Select Add.

Tap the Servers <img src={useBaseUrl('/img/ui/server-variant_E81F.svg')} alt="Access server connection options using the Servers icon." className="theme-icon" /> icon located in the top left corner of the window to access all available servers and to add new servers.

1. Tap Add a server.
2. Enter the server URL. Server URLs must begin with either http:// or https://.

Can't find your Mattermost server URL? Ask your company’s IT department or your Mattermost system admin for your organization’s Mattermost Site URL. It’ll look something like https://example.com/company/mattermost, mattermost.yourcompanydomain.com, or chat.yourcompanydomain.com. These URLs could also end in .net.

1. Enter the server's Display Name.
2. Optionally toggle the Advanced Options section to enter an Authentication secret. This is an additional security measure that some organizations use. Your system admin can provide you with the secret if required.

<img src={useBaseUrl('/images/mobile-server-add-psk.jpg')} width="300" alt="Mobile app server setup screen showing the optional authentication secret field." />

1. Tap Done.

Edit a server

1. Hover over a server and select the Edit icon.

   

2. Modify the server's display name or URL, then select Save.

[Desktop only] To update an authentication secret, connect to the server. If the secret has changed, you'll be prompted to enter the new one provided by your system admin.

1. Swipe left on an existing server entry to reveal additional options. Tap Edit.

<Video src={useBaseUrl('/images/swipe-left-to-remove.mp4')} alt="In the Mattermost mobile app, swipe left on an existing server connection entry to edit the connection." aspectRatio="488 / 1088" width={300} />

1. Modify the server's display name or authentication secret, and then tap Save.

<img src={useBaseUrl('/images/mobile-edit-server.jpg')} width="300" alt="Mobile app edit server screen showing display name fields." />

To view or update the authentication secret, expand the Advanced Options section. If a secret is currently configured, it will be pre-filled in the field.

Remove a server

Removing a server from your desktop app doesn't delete its data. You can add the server back any time.

1. Hover over a server and select Remove.

   

2. Select Remove when prompted to confirm.

Tap the Servers <img src={useBaseUrl('/img/ui/server-variant_E81F.svg')} alt="Access server connection options using the Servers icon." className="theme-icon" /> icon located in the top left corner of the window to access all available servers and to add new servers.

Swipe left on an existing server entry to reveal additional options. Tap Remove.