If you've recently executed the upcp command or performed a fresh installation of WHM, you may encounter an issue where the initial setup wizard becomes unresponsive or remains stuck at a URL similar to:
https://yourhostname.com:2087/cpsess*****/scripts4/initial_setup_wizard1
This may prevent you from accessing the WHM dashboard. Follow the steps below to bypass the issue and regain access.
Step 1: Apply the cPanel Tweak
Before attempting any of the methods below, run the following command as the root user:
/usr/bin/licD_cpanelv3 -tweak
Once the command has completed, refresh the WHM page and check whether the setup wizard loads correctly.
Method 1: Manually Bypass the Setup Wizard
The WHM setup wizard normally provides a Skip option that redirects to another script to complete the initial setup. If the interface becomes unresponsive and you cannot click the button, you can manually modify the URL.
Original URL:
https://yourhostname.com:2087/cpsess*****/scripts4/initial_setup_wizard1
Modified URL:
https://yourhostname.com:2087/cpsess*****/scripts4/initial_setup_wizard1_do/
This URL is intended to complete the setup step automatically and redirect you to the main WHM interface.
Method 2: Access the WHM Dashboard Directly
If the previous method does not work, try accessing the WHM dashboard directly using the following URL:
https://yourhostname.com:2087/cpsess*****/scripts2/top
This may allow you to bypass the setup wizard and continue configuring WHM.
Additional Step: Downgrade cPanel (If Necessary)
In rare cases where the setup wizard remains inaccessible, downgrading to a previous cPanel version within the same major release may resolve the issue.
cPanel Version Archive:
https://manual.cpanelcentral.com/cpvers
Please ensure the selected version is compatible with your server environment before performing a downgrade.
Final Notes
-
Verify that your server's hostname resolves correctly.
-
Ensure that DNS and firewall settings are not blocking access to WHM.
-
Review the cPanel logs for any errors that may help identify the underlying issue.
-
If the problem persists after following the steps above, please submit a support ticket for further assistance.
