MS Authenticator App

How to enable 2FA on Mattermost

Mattermost lets you secure your account with an authenticator app. With 2FA on, each login needs a fresh 6-digit code, keeping your Mattermost account safe even if your password leaks.

Step-by-step setup

  1. 1

    Sign in to Mattermost and open your Mattermost account security settings.

  2. 2

    Turn on two-factor authentication and choose the authenticator-app option.

    Look for "Authenticator app", "Authentication app", or "TOTP" rather than SMS.

  3. 3

    Scan the QR code with MS Authenticator App.

    Open MS Authenticator App, tap add, and point your camera at the QR code Mattermost displays. Can't scan? Enter the setup key manually instead.

  4. 4

    Enter the 6-digit code to confirm.

    Type the code MS Authenticator App generates to verify and link your Mattermost account.

  5. 5

    Save your backup codes.

    Store the recovery codes Mattermost gives you somewhere safe — you'll need them if you lose your phone.

Menu names on Mattermost can change — the official Mattermost 2FA documentation ↗ always has the exact, current path.

Frequently asked questions

Does Mattermost work with authenticator apps like MS Authenticator App?
Yes. Mattermost supports TOTP authenticator apps, so you can generate its two-factor codes in MS Authenticator App.
Is Mattermost two-factor authentication free?
Yes. Enabling authenticator-app 2FA on Mattermost is free — you only need the free MS Authenticator App.
What if I lose access to my Mattermost 2FA codes?
Use the backup or recovery codes you saved during setup. If you didn't save them, contact Mattermost support to regain access, then re-add the account to MS Authenticator App.

Generate your Mattermost codes in MS Authenticator App

Free, offline, and encrypted. One tap for every 6-digit code.

Get the app

More Communication guides

Novaz is not affiliated with, endorsed by, or sponsored by Mattermost. Mattermost and its logo are trademarks of their respective owner and are used here for identification only.