Skip to content
Rack Gateway

TOTP Setup

Time-based One-Time Passwords (TOTP) generate a 6-digit code that changes every 30 seconds.

Section titled “Recommended Apps”
AppNotes
1PasswordIntegrated with password manager
AuthyCloud backup, multi-device sync
Google AuthenticatorSimple, no account required
Microsoft AuthenticatorEnterprise-friendly

Setup Steps

Section titled “Setup Steps”
  1. Open Account Security in the web UI
  2. Click Enable MFA
  3. Choose Authenticator app
  4. Scan the QR code with your app
  5. Enter the 6-digit code to confirm
  6. Save the backup codes shown after confirmation

Manual Entry

Section titled “Manual Entry”

If you can’t scan the QR code:

  1. Click Copy secret for manual entry
  2. Add a manual TOTP entry in your app using that secret

Using TOTP

Section titled “Using TOTP”

Web UI

Section titled “Web UI”

Enter the 6-digit code when prompted for MFA. You can also trust the device to reduce prompts.

CLI

Section titled “CLI”
Terminal window
rack-gateway deploy -a myapp --mfa-code 123456

Troubleshooting

Section titled “Troubleshooting”
  • Verify your device time is accurate
  • Wait for the next code if a code is near expiry
  • Ensure you’re using the correct account in your app