Two-Factor Authentication is a great security layer for your Webuzo panel — until it locks you out. Webuzo doesn't offer a direct terminal command to disable 2FA, but you can do it manually by editing a single configuration file. Here's how.

💡
Before you start — make a backup

Always copy universal.php somewhere safe before editing it. A one-line mistake in a config file can take down your panel entirely.

The Steps

1

Locate the configuration file

The 2FA settings live here:

/usr/local/webuzo/universal.php

You can reach it via SSH (connect as root and open with nano or vi) or via your hosting control panel's File Manager.

nano /usr/local/webuzo/universal.php
2

Find the 2FA section

Search the file for the 2fa key. It looks like this:

$globals['2fa'] = array(
    'root' => array(
        'app' => array(
            'key' => 'MVNSVlpXVE82SA==',
        ),
        'status' => 1,
        'otp_app' => true,
        'question' => false,
        'otp_email' => false,
        'force_otp_email' => false,
        'roles' => array()
    )
);

In nano you can jump straight to it with Ctrl+W and searching for 2fa.

3

Change the status value

Inside that array, find the 'status' field and flip it from 1 to 0:

Before
'status' => 1,
After
'status' => 0,

That single character change is all it takes.

4

Save and close the file

In nano, press Ctrl+O to write the file, then Ctrl+X to exit. In File Manager, use the built-in Save button.

The change takes effect immediately — no Apache or service restart needed. You can now log into Webuzo without the 2FA prompt.

After You're Done

⚠️
Don't leave it off

Disabling 2FA reduces your panel's security. Once you've regained access or finished troubleshooting, go back into universal.php and set 'status' => 1 again — or re-enable 2FA from within the Webuzo interface.

  • Regained access to the Webuzo panel
  • Finished your troubleshooting task
  • Re-enabled 2FA and verified it works
  • Kept or deleted the backup of universal.php

TL;DR

Open /usr/local/webuzo/universal.php, find 'status' => 1 inside the $globals['2fa'] array, change it to 'status' => 0, save. Done — no restart required. Re-enable when you're finished.