Signing In

Accessing your Mattermost Workspace

An invitation is required to access Mattermost. A member of your Mattermost workspace can send an invitation via email or by providing you with a link.

Sign In

To sign in, navigate to the Mattermost sign-in screen. You can get the URL of the sign-in screen from your System Admin or in an invitation email. We recommend bookmarking the site so you can easily find it again.

After signing in, the team that appears first on your team sidebar will open. If you have not joined a team, the Team Selection page opens where you can view a list of teams that you can join.

Sign In Methods

There are several options for signing in to your team depending on how your System Admin has configured your server.

Email Address or Username Sign In

When enabled by your System Admin, you can sign in with the username or email address used to create your account.

If you’ve forgotten your password, you can reset it by selecting I forgot my password on the sign-in screen, or contact your System Admin for help resetting your password.

Sign in to Mattermost with your username or email address, or reset your password.

GitLab Single Sign-On (SSO)

When enabled by your System Admin, you can sign in with your GitLab account using a one-click sign in option.

Sign in to Mattermost using your GitLab credentials.

Google Single Sign-On (SSO)

Available in Enterprise Edition E20

When enabled by your System Admin, you can sign in with your Google account using a one-click sign in option.

Sign in to Mattermost using your Google Apps credentials.

Office 365 Single Sign-On (SSO)

Available in Enterprise Edition E20

When enabled by your System Admin, you can sign in with your Office 365 account using a one-click sign in option.

Sign in to Mattermost with your Office 365 credentials.

AD/LDAP Sign In (SSO)

Available in Enterprise Edition E10 and E20

When enabled by your System Admin, you can sign in with your AD/LDAP credentials. This lets you use the same username and password for Mattermost that you use for various other company services.

Sign in to Mattermost with your AD/LDAP credentials.

SAML Single Sign-On (SSO)

Available in Enterprise Edition E20

When enabled by your System Admin, you can sign in with your SAML credentials. This lets you use the same username and password for Mattermost that you use for various other company services. Mattermost officially supports Okta and Microsoft ADFS as an identity provider (IDP) for SAML, but you may use other SAML IDPs as well. Please see documentation to learn more about configuring SAML for Mattermost.

../../_images/sign-in_with_saml.png

Switching Teams

You can switch between teams you have joined using the team sidebar that appears to the left of your channel list on the left-hand sidebar.

Switching teams in Mattermost.

Logging Out

You can log out from the Main Menu (the three lines next to your username). Select Logout to log out of all teams on the server.

iOS Setup

Your Mattermost teams can be accessed on iOS mobile devices via the Mattermost Mobile App.

  1. Open the App Store on your Apple device running iOS 9.0 or later.

  2. Search for “Mattermost” and select GET to download the app.

  3. Open Mattermost from your homescreen and enter your team and account information to log in:

    1. Enter Server URL: This is the web address you go to when you want to access Mattermost. It’s in the format https://domain.com. You can find the Server URL by asking your System Admin, or by looking at the address bar in a desktop browser tab with Mattermost open.

    2. Sign in to Mattermost: This is your account login information as described by one of the sign in methods above.

Android Setup

Your Mattermost teams can be accessed on Android mobile devices by downloading the Mattermost Mobile App.

  1. Open the Play Store on your Android device.

  2. Search for “Mattermost” and select INSTALL to download the app.

  3. Open Mattermost from your homescreen and enter your team and account information to login:

    1. Enter Server URL: This is the web address you go to when you want to access Mattermost. It’s in the format https://domain.com. You can find the Server URL by asking your System Admin, or by looking at the address bar in a desktop browser tab with Mattermost open.

    2. Sign in to Mattermost: This is your account login information as described by one of the sign in methods above.