Access your workspace#

plans-img Available on all plans

deployment-img Cloud and self-hosted deployments

Mattermost 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

  • Is your Mattermost hosted externally? You can access Cloud workspaces from the Cloud Workspace Connection page by specifying your company or domain name.

  • 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 Office 365, 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 enabled by your system admin, you can log in with the username or email address used to create your 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, Office 365, 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 Office 365 account using a one-click login option.

Log in to Mattermost with your Office 365 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 your SAML credentials.