GearOSWiki
TreeFilters

MFA Setup (Register TOTP)

This page enrolls your account in multi-factor authentication (MFA) using TOTP codes from an authenticator app (Google Authenticator, Authy, 1Password, etc).

Platform

#MFA Setup (Register TOTP)

This page enrolls your account in multi-factor authentication (MFA) using TOTP codes from an authenticator app (Google Authenticator, Authy, 1Password, etc).

#How to get here

  1. Open Account Settings
  2. Tap Set up MFA

#How to enable MFA

  1. Scan the QR code with your authenticator app
  2. Enter the 6‑digit code shown in your authenticator app
  3. Tap Verify

If enrollment succeeds, the app confirms MFA is enabled and returns you to where you started.

#Helpful controls

Depending on your build, you may see:

  • Show/hide the secret key (if you can’t scan the QR code)
  • Regenerate the enrollment QR/secret (if needed)

#Cancel / close

Use the close (X) button to dismiss the flow if you don’t want to enable MFA right now.

#Platform behavior

#iOS

  • The workflow and labels on iOS follow this page as written.
  • Controls (pickers, sheets, and permissions dialogs) use native iOS presentation.

#Android

  • The workflow and labels on Android follow this page as written.
  • Controls (pickers, sheets, and permissions dialogs) use native Android presentation.

#Web

  • No standalone MFA register route is exposed on web.
  • MFA enrollment is initiated from account security controls (see /account).
  • Web security setup flows are integrated into account management pages.