Documentation contents

Account verification with an authenticator app (TOTP)

When signing in with a password, you can use a code from your authenticator app as your second factor. Save the recovery codes in case you lose your phone.

Gadka accepts TOTP codes from authenticator apps such as Microsoft Authenticator, Google Authenticator or 1Password. Each user sets up verification on their own account.

Server settings

KeyDefaultPurpose
crypto.mfa_key_file/etc/gadka/mfa-key (created by the installer)Key used to encrypt 2FA secrets
auth.mfa.required_for_adminstrueRequires a session verified with a second factor to access admin pages

Enable 2FA on your account

  1. Click your avatar in the lower left and select Security.
  2. Click Turn on two-step verification.
  3. In Confirm it's you, enter your account password and click Continue. If you only sign in through SSO, leave the field blank.
  4. Scan the QR code with your authenticator app or enter the Key for manual entry.
  5. Enter all six digits of the code from the app and click Confirm.
  6. In Save your recovery codes, click Copy codes or Save to file, then Done.

You receive 10 recovery codes. Each works once, and this is the only time Gadka displays them.

The next time you sign in with your password, the Two-step verification screen will ask for a code.

Sign in without your phone

On the verification screen, click Use a recovery code and enter one of your saved codes.

Disable 2FA

  1. Click your avatar, open Security and select Turn off.
  2. Enter your password and either a current code from your app or an unused recovery code.

Switch to a new phone

  1. Sign in with a recovery code.
  2. Disable 2FA using another recovery code.
  3. Enable 2FA again and scan the QR code on your new phone.

If someone loses their phone and all their recovery codes, administrators cannot reset their 2FA in the current version of Gadka. Their only way back in is through SSO already linked to that account.

When administrators need 2FA

With auth.mfa.required_for_admins: true, owners and administrators who sign in without a second factor see Administration requires two-step verification. They cannot open the members, invitations or license pages. Either TOTP in Gadka or multifactor authentication confirmed by the organization's identity provider satisfies the requirement.