Log in to Mattermost
Available on all plans
Cloud and self-hosted deployments
Mattermost is accessible through a server link. You’ll receive the server 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, or the mobile app.
Tip
If you’re looking to create a Mattermost workspace, start a free Cloud trial and then come back to this page.
Mattermost Cloud customers can log into their Cloud workspaces from the Cloud Workspace Connection page by specifying their 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, orchat.yourcompanydomain.com. These URLs could also end in.net.
Web browser
Open a web browser.
Copy and paste the Mattermost server link into the browser’s address field.
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
Download and install the Mattermost desktop app.
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.
Enter your user credentials to log into Mattermost.
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.
Download and install the Mattermost mobile app.
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.
Enter your user credentials to log into Mattermost.
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.
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.
When enabled by your system admin, you can log in with your Google account using a one-click login option.
When enabled by your system admin, you can log in with your Office 365 account using a one-click login option.
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.
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.
