The failurls File

Not only can you create and brand your own custom login forms, but you can also create custom error pages for those forms.

The failurls file, located at /var/cpanel/failurls, is a list of locations where resellers can redirect users who fail to authenticate with cPanel through custom login forms.

Each entry in this file must be on a separate line. Also, entries in the failurls file must meet the following requirements:

1. Each entry must be a static URL.
   • For example: http://example.com/index.php?failed=1 is a dynamic URL, so it is not valid
2. Dynamic content on the login page must be passed via hidden POST variables. GET query strings will fail because they will not match any entry in the failurls file exactly.
   • For example: <input type="hidden" name="failurl" value="http://example.com/failed.html" /> is a valid hidden POST variable.
3. The failurl value in the custom login form must exactly match one of the entries in the failurls file.
   • For example: http://example.com/failed.html in the failurls file matches with <input type="hidden" name="failurl" value="http://example.com/failed.html" /> exactly.

After you create the entries in the failurls file, you must restart cPanel.

To restart cPanel, run the following command as the root user:

/usr/local/cpanel/startup