How to enable two-factor authentication (2FA) for your login
With two-factor authentication, signing in needs your password and a 6-digit code from an app on your phone. A stolen or guessed password alone is then not enough. It works for administrators, resellers, customers and team members.
Before you start
Install an authenticator app on your phone, for example Google Authenticator, Authy, 1Password or Microsoft Authenticator.
Steps
- Open the two-factor page:
- Administrator or reseller: admin panel (
https://<server>:2087) → Two-Factor Auth (section Account). - Customer or team member: control panel (
https://<server>:2083) → Two-Factor Auth (section Advanced).
- Administrator or reseller: admin panel (
- Under 1. Scan this QR code, scan the code with the app. If you cannot scan, enter the key shown below it by hand.
- Under 2. Enter the code from the app, type the current 6-digit code.
- Click Enable two-factor authentication. The badge at the top changes to Enabled.
- Your recovery codes appear once. Click Copy codes and store them somewhere safe, away from your phone.
Signing in with two-factor
- Enter your username (or email, for team members) and password as usual.
- On the Verification page, enter the code from the app in Authentication code, or one of your recovery codes.
- Click Verify.
Good to know
- 10 recovery codes, each usable once. The page shows how many are left. To get a new set, enter your Current password and click Generate new codes; the old ones stop working.
- A code works only once. The app shows a new one every 30 seconds; the one just before or after is accepted too. If codes are refused, check that your phone's time is set automatically.
- You have 5 minutes and 5 tries on the verification page. After that, start again with your password. Wrong codes count as failed logins for brute force protection.
- To turn it off, enter your Current password under Disable and click Disable.
- Phones signed in to the app (the mobile app) are listed on the same page. Sign out a phone you lost.
Common questions
It says "The code is not valid. Check your phone's time and try again."
The phone's clock is off, or the code expired while you typed it. Turn on automatic date and time on the phone and use a fresh code.
I lost my phone. How do I sign in?
Use a recovery code. Without one, see lost two-factor phone.
Does each team member need their own 2FA?
Yes. 2FA protects one login. Each team member turns it on for themselves; see two-factor for team members.
Thank you — this helps us improve the article.
Still stuck?
Ask the AI about your exact situation — it answers from this knowledge base — or contact us.
Related articles
- Lost your two-factor phone? How to sign in again
Sign in without your authenticator app using a recovery code, or have two-factor authentication turned off for an admin, reseller, customer or team member.
- Two-factor authentication for team members
How team members protect their own control panel login with two-factor authentication, and how the account owner turns it off when a member loses a phone.
- How to set up brute force protection for panel logins
Block IP addresses after repeated failed logins to the admin panel, control panel and API: set max failures, the time window, block time and whitelisted IPs.
- How to restrict the admin panel to your IP addresses
Allow only your own IP addresses or ranges to open the admin panel on port 2087, and how to get back in with one command if you lock yourself out.