Troubleshooting Admin Directory Errors: A Comprehensive Guide

WHMCS displays one of the error messages below when it detects a conflict between your settings and the admin directory path that you are trying to access.

Cause

The $customadminpath line does not appear or is invalid in the WHMCS configuration.php file.

Solution

Update the configuration.php file with the correct path. For steps to do this, see Renaming the WHMCS Admin Directory.

Workaround

If you continue to see the error message, revert your admin directory name to admin in order to regain access. Then, contact our support team for assistance.

Cause

The admin directory path that you are trying to access is not the directory that you specified in the configuration.php file.

Solution

Update the configuration.php file with the correct path. For steps to do this, see Renaming the WHMCS Admin Directory.

Workaround

If you continue to see the error message, revert your admin directory name to admin in order to regain access. Then, contact our support team for assistance.

Cause

You have specified a custom $customadminpath directory in the WHMCS configuration.php file but, when you attempt to access it, WHMCS is also detecting an admin directory.

Typically, this indicates that you recently applied an update and some of the update files uploaded to the default admin directory. Because of this, the files in your custom admin directory may not be up to date.

Solution

Make certain that you have uploaded all of the latest files to your custom admin directory and then delete the default admin directory and its contents.

Cause

The admin directory has been renamed to a value which conflicts with a reserved system name, such as login.

Solution

Choose a different custom name for the admin login directory, such as administration.

For more information see Renaming the WHMCS Admin Directory.