Enable Two-Factor Authentication (2FA) for WHM accounts to add an extra layer of security to the server management interface. This process ensures that only authorized users with both a password and a unique time-based code can access the WHM control panel.
Before you begin
You will need:
Server Administrator access to WHM
A mobile device or hardware token capable of generating Time-based One-Time Passwords (TOTP)
Enable Two-Factor Authentication
Log in to WHM.
Navigate to Security Center > Two-Factor Authentication.
Locate the account you wish to secure in the list.
Select the checkbox next to the account.
Click the Enable button.
A QR code will be displayed. Use a 2FA authenticator app (such as Google Authenticator or FreeOTP) to scan the code.
Enter the 6-digit code provided by your app into the verification field.
Click Verify.
Warning: Ensure you save the secret key or complete the setup in your authenticator app before logging out. If you lose access to your 2FA device and have not saved the backup keys, you may be locked out of the WHM account.
Confirm the result
The account status in the Two-Factor Authentication list will show as enabled.
When logging into WHM, the system will now prompt for a 6-digit code after the password is entered.
If a user is locked out of WHM due to 2FA
If a user is locked out because they lost their 2FA device, a Server Administrator can disable the requirement for that specific user.
In WHM, navigate to Security Center > Two-Factor Authentication.
Locate the locked-out account.
Select the account and click Disable.
The user can then log in with only their password.
The user should then re-enable 2FA using a new device.
Limitations
This procedure applies only to the WHM interface. Enabling 2FA for WHM does not automatically enable 2FA for individual cPanel accounts; those must be configured separately within the cPanel interface.
