Signing in

To sign in, navigate to the Mattermost sign-in page. You can get the URL of the sign-in page from your administrator.

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 have forgotten your password, you can reset it by clicking I forgot my password on the sign in screen, or contact your System Admin for help resetting your password.

../../_images/sign-in_with_email.png

GitLab Single Sign-On (SSO)

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

../../_images/sign-in_with_gitlab.png

Google Single Sign-On

Available in Enterprise Edition E20

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

../../_images/sign-in_with_google_apps.png

Office 365 Single Sign-On

Available in Enterprise Edition E20

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

../../_images/sign-in_with_office_365.png

AD/LDAP Sign In

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.

../../_images/sign-in_with_ldap.png

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 left of your channel list on the left-hand sidebar.

../../_images/team-sidebar.png

Setting Your Status

You can set your status as online, away, do not disturb, or offline by selecting a status from the menu that appears when you click your avatar at the top of the channel list. Do not disturb disables desktop, email and push notifications.

Image of avatar showing the status selection menu with the options online, away, and offline

How Mattermost determines your status

Client Online Away Offline
Desktop App You’re interacting with your computer You’re inactive on your computer for 5 minutes You close Mattermost, sleep or lock your computer
Web Browser You’re interacting with Mattermost in a browser You’re inactive in the Mattermost browser window for 5 minutes You close the Mattermost browser window
Mobile App Mattermost is open Mattermost is open with 5 minutes of inactivity You switch apps, close Mattermost, or lock your screen

Logging Out

You can log out from the Main Menu, which is accessed by clicking the three dots in the top header on the left side of the screen. Clicking Logout logs you out of all teams on the server.

iOS Setup

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

  1. Open the App Store on your Apple device running iOS 9.0 or later.
  2. Search for “Mattermost” and click GET to download the App for free.
  3. Open Mattermost from your homescreen and input 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. 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. It is in the form https://domain.com.
    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 App.

  1. Open the Google Play Store on your Android device.
  2. Search for “Mattermost” and click INSTALL to download the App for free.
  3. Open Mattermost from your homescreen and input 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. 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. It is in the form https://domain.com.
    2. Sign in to Mattermost: This is your account login information as described by one of the sign in methods above.