Skip to main content
RelayHub supports TOTP-based multi-factor authentication (MFA) to add a second layer of security to user accounts. When enabled, users must provide a time-based one-time password from an authenticator app in addition to their email and password.

​
Setting Up MFA

1

Open your account settings

Click your profile avatar in the bottom-left corner of the sidebar, then select Account Settings.
2

Navigate to Security

Select the Security tab in your account settings.
3

Click Enable MFA

Click the Enable Multi-Factor Authentication button to begin setup.
4

Scan the QR code

A QR code will appear on screen. Open your authenticator app (Google Authenticator, Authy, 1Password, or any TOTP-compatible app) and scan the code to add RelayHub.
5

Enter the verification code

Your authenticator app will display a 6-digit code. Enter it in the verification field to confirm the setup is working.
6

Save your backup codes

RelayHub generates a set of one-time backup codes. Save these in a secure location. Each backup code can be used once to log in if you lose access to your authenticator app.
Store your backup codes securely — they are the only way to recover your account if you lose your authenticator device. RelayHub cannot reset MFA without a backup code or admin intervention.

​
Logging In with MFA

Once MFA is enabled, the login flow adds one extra step:
  1. Enter your email and password as usual
  2. When prompted, open your authenticator app and enter the current 6-digit code
  3. You are logged in after the code is verified
Codes rotate every 30 seconds. If a code expires while you are typing it, wait for the next code and try again.

​
Using Backup Codes

If you cannot access your authenticator app:
1

Click 'Use a backup code'

On the MFA verification screen, click the Use a backup code link.
2

Enter a backup code

Type one of your saved backup codes. Each code can only be used once.
3

Reconfigure MFA

After logging in with a backup code, go to Account Settings > Security and re-enable MFA with a new QR code to refresh your setup.
Each backup code is single-use. After using one, it is permanently consumed. If you are running low on backup codes, disable and re-enable MFA to generate a fresh set.

​
Disabling MFA

To turn off MFA for your account:
  1. Go to Account Settings > Security
  2. Click Disable MFA
  3. Enter your current authenticator code or a backup code to confirm
  4. MFA is removed from your account immediately

​
Compatible Authenticator Apps

Any app that supports the TOTP standard (RFC 6238) works with RelayHub:
  • Google Authenticator (iOS, Android)
  • Authy (iOS, Android, Desktop)
  • 1Password (built-in TOTP support)
  • Microsoft Authenticator (iOS, Android)
  • Bitwarden (built-in TOTP support)
Authy and 1Password support cloud backup of your TOTP secrets, making it easier to recover if you switch devices. Google Authenticator requires manual transfer.