Skip to content

Two-step sign-in

Your password alone isn’t enough to get in. With two-step sign-in on, signing in with your server password, on the web or in the Frameleaf apps, also asks for a 6-digit code from the authenticator app on your phone. The code changes every 30 seconds, so someone who learns your password still can’t get in.

Find it in Settings, then Your sign-in & privacy, then Two-step sign-in. The page opens on whether it’s on, then shows Your two-step sign-in: Authenticator app, Recovery codes and Browsers you trust, with Change password, Good to know and Advanced below.

  • An authenticator app on your phone. Any one works, such as Google Authenticator, Microsoft Authenticator or 1Password. Install one first if you don’t have one.
  • Your Frameleaf password, to show it’s you. Passwords are at least 8 characters.
  • Somewhere safe to keep 10 recovery codes, such as a password manager or a printed page, away from your phone.
  • About five minutes.
  1. Open Settings, then Your sign-in & privacy, then Two-step sign-in, and select Turn on….
  2. In Turn on two-step sign-in, enter your password and continue.
  3. Add Frameleaf to your authenticator app: open the app, choose to add an account (often a + button), then scan the QR code. Keep the code to yourself, because anyone who scans it can make your codes.
    • Can’t scan it? Choose to enter a key in your app instead and type the key shown. Copy key puts it on the clipboard. The account name is Frameleaf.
  4. Select I’ve added it, then enter the 6-digit code your app shows and select Turn on. Two-step sign-in doesn’t turn on until this works.
  5. Save your recovery codes. Use Download or Print, keep them somewhere safe, then tick I saved them somewhere safe and select Done.

Your recovery codes are shown only this once. Frameleaf keeps a scrambled copy it can check but can’t show you.

After your email and password, Frameleaf shows Enter your code. Type the 6-digit code from your authenticator app. Pasted codes with spaces or dashes are cleaned up for you.

  • Use a recovery code when you can’t use your phone. Each recovery code works once.
  • Trust this browser for 30 days skips the code in this browser for 30 days, or until you change your password. Don’t tick it on a shared computer.
  • Lost your phone and your recovery codes? tells you what to do next. See Lost your phone.

Enter the code within 5 minutes of your password. If you take longer, you see This sign-in expired; enter your password again.

After 5 wrong codes in one sign-in, you see Too many tries and signing in pauses for 10 minutes. Then sign in again with your password. The pause stops anyone guessing their way in.

If you sign in with your last recovery code, you see You’ve used your last recovery code. Make new ones straight away, so you can still get in if you lose your phone.

The iPhone and Android apps ask for the code too when you sign in to a server with your email and password. Enter the 6-digit code, or choose Use a recovery code. The code sends by itself once all six digits are in, and your phone can fill it from your password manager. The apps show the same messages as the web: how many tries are left, Too many tries with a countdown, and This sign-in expired. Trust this browser is only on the web.

Recovery codes shows how many of your 10 codes are left. Each one gets you in once when you can’t use your phone. When you’re down to your last code, the page warns you.

To get a fresh set, select Make new codes…. Make new recovery codes? explains that every code you have now stops working, even ones you haven’t used. Your authenticator app doesn’t change.

Got a new phone? Select Move to a new phone… under Authenticator app:

  1. Show it’s you with your password and a code from your old phone. Old phone lost or wiped? Use a recovery code instead.
  2. On your new phone, scan the new QR code. The one on your old phone doesn’t carry over.
  3. Enter the code your new phone shows to finish the move.

Your old phone keeps working until the move is done. After that, codes from the old phone stop working, and you can delete Frameleaf from its authenticator app. Your recovery codes stay the same, and the move is noted in your account history.

A browser where you ticked Trust this browser for 30 days skips the code for 30 days. Change password ends that on every browser at once. Passwords are at least 8 characters.

Select Turn off on the Two-step sign-in page. Turn off two-step sign-in? asks for your password and a code, so nobody can turn it off from a browser you left signed in. Select Keep it on to change your mind, or Turn off to go ahead.

You then sign in with your password alone. Your recovery codes stop working. If you turn it on again, you scan a new code and get new recovery codes.

  1. Use a recovery code. On Enter your code, choose Use a recovery code and enter one of the codes you saved. Then use Move to a new phone… to set up your new phone, and make new recovery codes if you’re running low.
  2. No recovery codes either? Ask your server administrator. They can turn off two-step sign-in for your account, and you sign in with your password alone until you turn it on again.

Open Settings, then Users, and select the person. On their page, Two-step sign-in says whether it’s on. Select Turn off two-step sign-in… and confirm with Turn off.

  • Do this only when you’re sure it’s really them asking, for example in person or on a call you made. Anyone else could use it to get past their phone.
  • Their recovery codes stop working, browsers they trusted forget it, and they’re signed out on every device.
  • It’s noted in their account history, with your name.
  • Only they can turn it on again, in their own sign-in settings.

See Users.

  • After 5 wrong codes, signing in pauses for 10 minutes.
  • A browser you trust skips the code for 30 days, or until you change your password.
  • Lost your phone and your recovery codes? Your server administrator can turn it off for you, and it’s noted in your account history.
  • Wrong passwords have their own short waits, which never lock you out. See Wrong passwords.
  • When your account signs in from a device or network your server hasn’t seen before, you get an email. See New sign-in emails.
  • Turning two-step sign-in on or off, moving it to a new phone and every wrong code are listed in your account activity.
  • Your administrator can ask for a passkey or two-step sign-in: from administrators away from home, from everyone away from home, or from everyone, everywhere. See Require a passkey or two-step.

Two-step sign-in protects signing in with your server password, on the web and in the apps. Other ways to sign in don’t ask for an authenticator code, because they use their own security:

  • A passkey signs you in with your face, fingerprint or screen lock instead of your password, with no code. See Passkeys.
  • Sign in with Frameleaf uses your Frameleaf account’s own sign-in and its security, on the web and in the iPhone and Android apps. See Sign in.
  • Your server’s own sign-in provider, such as Authentik, Keycloak or Google, uses that provider’s security, including any two-step sign-in you set up there. See Sign-in and OAuth.

If your account doesn’t sign in with a password on this server, the page says Two-step sign-in needs a password, because there’s nothing for it to protect.

The codes are time-based one-time passwords (TOTP, RFC 6238): 6 digits, a new one every 30 seconds. The code just before or after is also accepted, in case your phone’s clock is up to 30 seconds out, and each code works only once. Recovery codes look like xxxxx-xxxxx.