Access your workspace#

plans-img Available on all plans

deployment-img Cloud and self-hosted deployments

Your Mattermost workspace is accessible through a URL link. You’ll receive a link from your Mattermost system admin or through an email invitation. You can use that link in a web browser, or as a server connection in the desktop app, the mobile app for iOS, or the mobile app for Android.

Tip

Can’t find your Mattermost link? 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.

Web browser

  1. Open a supported web browser.

  2. Copy and paste the Mattermost server link into the browser’s address field.

  3. Enter your user credentials to log into Mattermost.

Tip

  • We recommend bookmarking the Mattermost URL in your browser of choice so logging into Mattermost is easy in the future.

  • The credentials you use to log in depend on how your system admin has configured Mattermost. You may be prompted for an email address or username and a password, or you may be able to log in using other credentials. Contact your system admin for more information.

Desktop app

  1. Download and install the Mattermost desktop app.

  2. 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 documentation for details.

  3. Enter your user credentials to log into Mattermost.

  4. 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) section below for details on the external providers that Mattermosts supports.

  1. Download and install the Mattermost iOS mobile app or the Android mobile app.

  2. 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 documentation for details.

  3. Enter your user credentials to log into Mattermost.

  4. 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.

Tip

The credentials you use to log in depend on how your system admin has configured Mattermost. You may be prompted for an email address or username and a password, or you may be able to log in using other credentials. Contact your system admin for details.

Reset your password#

If you’ve forgotten your password, you can reset it on the login screen by selecting Forgot your password?, or by contacting your system admin for assistance.

Email address or username#

When account creation with email is enabled by your system admin, you can log in with the username or email address used to create a Mattermost account.

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

Single Sign-On (SSO)#

When enabled by your system admin, you may log in using your GitLab, Google, Entra ID, AD/LDAP, or SAML credentials.

When enabled by your system admin, you can log in with your GitLab account using a one-click login option.

Log in to Mattermost using your GitLab credentials.

When enabled by your system admin, you can log in with your Google account using a one-click login option.

Log in to Mattermost using your Google Apps credentials.

When enabled by your system admin, you can log in with your Entra ID account using a one-click login option.

Log in to Mattermost with your Entra ID credentials.

When enabled by your system admin, you can log 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.

Log in to Mattermost with your AD/LDAP credentials.

When enabled by your system admin, you can log 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, OneLogin, and Microsoft ADFS as an identity provider (IDP) for SAML, but you may use other SAML IDPs as well. See our SAML Single Sign-On documentation to learn more about configuring SAML for Mattermost.

Log in to Mattermost with SAML credentials, such as OneLogin.

Multi-factor authentication#

If your system admin enables multi-factor authentication for your Mattermost instance, you can optionally set up multi-factor authentication for your Mattermost user account by selecting your profile picture located in the top-right corner of Mattermost, and going to Security > Multi-Factor Authentication.

If your system admin enforces multi-factor authentication, you are required to set up multi-factor authentication for your Mattermost account. When you attempt to log in to Mattermost, you’re directed to the multi-factor authentication setup page. You won’t be able to access Mattermost until multi-factor setup is complete. If you encounter issues setting up multi-factor authentication, contact your Mattermost system admin for assistance.