I don’t know if you’ve heard, but a lot of new users have been joining Mastodon these past few weeks! Awesome!

I thought I’d explain how to enable two-factor authentication on a Mastodon account. This tutorial will assume you’re logged in on a desktop/laptop computer – I think it’s far easier to set-up two-factor authentication on a computer, as opposed to a mobile device.

Disclaimer: I’m not a cybersecurity professional.

What is two-factor authentication?

Normally, online accounts like your Mastodon account are only protected by a password. That’s all that an attacker would need to know to access your account. So to make your account harder to get into, we can add what’s called a “second factor”.

Turning on two-factor authentication means that whenever you log into your account, after entering your regular password as usual, you’ll then have to enter a 6-digit number (called a “token”) displayed on an app on your phone. The idea here is that even if an attacker gets your password, they would also need your phone to get this code.

There are different ways to receive this 2nd factor code, but for most of this guide, we’re going to focus on what’s referred to as “Authenticator-app” 2-factor (or sometimes “TOTP”). This is more secure than using SMS for a variety of reasons.

TL;DR It makes your Mastodon account more secure.

OK, I’m convinced. Let’s do this.

First, you’ll need to download an authenticator app for your smartphone or other mobile device. You may already have one installed, which you can likely use for Mastodon as well.

If you don’t have an authenticator app already, an easy-to-use option is Google Authenticator, which is available for both Android and Apple iOS apps.

Other easy-to-get-started options include: Aegis Authenticator for Android, Tofu for iPhone users, and Free OTP (iPhone or Android). (A slightly more involved option, which offers things like back-ups, is Authy.)

With one of these authenticator apps installed, log in to your Mastodon account on a desktop browser (like Firefox, Safari, or Chrome). If you’ve never done this before, go to your instance’s URL. For example, if your Mastodon user name is bob@mastodon.social, you’ll want to go to mastodon.social and find the “sign in” button to log in. I’m schlink@octodon.social, so I go to octodon.social.

Then find your user Preferences, usually on the right side of the screen.

Go to Mastodon preferences

On the left-hand side, find the “Account” section.

Go to Account

Next, click in to the “Two-factor auth” sub-section.

Go to Two-factor auth

Click the big wide “SET UP” button.

Click the big SET UP button

You’ll now be presented with a square QR code and a text string of uppercase letters and numbers. Both the QR code and the text string represent your second-factor “secret”.

QR code and text codes exposed

We want to scan this QR code into your authenticator app. Get out your mobile device and open your authenticator app.Depending on the app, you’ll need to tap a button to add a new account via scanning a QR code. Hold your phone up to the computer monitor, framing the QR code with your camera. Your authenticator app should add your Mastodon account and display a 6-digit number (called a “token”) that changes every 30 seconds. (Optionally, you can store the text secret somewhere safe, like a piece of paper.)

Tofu displaying a 6-digit token, after proper set up

Enter the current 6-digit token and click ENABLE to continue.

Recovery codes

Next, you’ll be presented with 10 recovery codes.

Sample recovery codes

If you lose your phone and can’t get the 6-digit token, you can use one these recovery codes to regain access to your account. Store these in a safe place. For example, you may print them out (or write them down by hand on a piece of paper) and store them with other important documents. While tempting, it’s best NOT to take a photo of your recovery codes, since your photos may not be stored/backed-up in a very secure way.

All done!

All done! You did it! Next time you log-in to your Mastodon account, you’ll first enter your password, and then you’ll be prompted to enter your “Two-factor code”.

Logging in with a second factor

If you have your mobile device, you’ll read and enter the 6-digit token your authenticator app presents at the time. If you don’t have access to your mobile device, you can enter one of the recovery codes.

If you want to add a bit more security to your account, and have ~$45 to spend, check out my guide for adding a physical security key as an alternate second factor.

Further reading

For more tips on how to protect yourself online, checkout the EFF’s Surveillance Self-Defense site.

Questions? Comments? General feedback?

I’m @schlink@octodon.social. Please let me know if you have questions or comments on how to make this guide better!


If you liked this blog post, I’m currently looking for work. Please get in touch! Here’s my website, Github, Twitter, LinkedIn, and Mastodon.