When logging into your server's cPanel or WHM dashboard, you expect a modern, clean interface. However, server updates, theme configuration changes, or browser caching issues can sometimes cause the login page to display an outdated, broken, or unstyled legacy theme. This can raise security concerns for clients who might worry the site has been compromised or modified by unauthorized users.
This layout issue is typically due to server-side asset mismatches, incorrect theme configurations in WHM, or browser caching of legacy stylesheets. In this guide, we will explore why the cPanel/WHM login page shows an outdated theme and walk through the steps and SSH commands to fix the issue.
1. Why the cPanel/WHM Login Page Displays Legacy Themes
cPanel uses a service daemon called cpsrvd to serve the WHM and cPanel administrative interfaces on ports 2083, 2087, and 2096. This daemon relies on compiled theme files and asset bundles stored in /usr/local/cpanel/base/.
Common causes of display issues include:
- Failed cPanel Updates: If a cPanel update is interrupted, some template files may not compile correctly, leading the system to fall back to legacy templates.
- Theme Configuration Changes: Modifying the default theme configurations in WHM can cause cPanel to serve fallback stylesheets.
- Browser Caching: Web browsers cache static files aggressively. Legacy stylesheets cached in the browser can conflict with updated server templates.
2. Step-by-Step Troubleshooting via SSH
To resolve cPanel/WHM login page display issues, log into your server via SSH as the root user. Run these commands to check configurations, rebuild assets, and reset default themes.
Step 2.1: Clear Browser Cache and Test Private Browsing
Before running commands on the server, verify if the issue is client-side. Open a private browsing window (Incognito mode) and load the cPanel or WHM login page. If the page displays correctly, the issue is due to local browser caching. Clear your browser cache and cookies to resolve the conflict.
Step 2.2: Rebuild cPanel Login Page Templates
If the issue persists in private browsing, force cPanel to rebuild its login page templates and clear cached static assets by running the following script via SSH:
/usr/local/cpanel/scripts/rebuild_login_themeThis script compiles the login page assets and updates theme links. Once complete, refresh your browser to check the login page.
Step 2.3: Reset the Default WHM and cPanel Themes
If the templates are rebuilt but the login page still uses a legacy theme, check and reset the default themes for cPanel and WHM. Run these commands to verify current theme settings:
cat /var/cpanel/sysdefaultthemeIf the output displays an outdated theme (like x3 or paper_lantern), reset the default theme to the modern jupiter theme by running:
echo "jupiter" > /var/cpanel/sysdefaultthemeTo update the default WHM theme to the standard bootstrap theme, run:
echo "bootstrap" > /var/cpanel/sysdefaultwhmthemeStep 2.4: Run cPanel Maintenance and Update Scripts
If a failed update caused the asset mismatch, run cPanel's automated maintenance and update scripts to check and repair system files:
/usr/local/cpanel/scripts/upcp --forceThe upcp --force command downloads and installs cPanel updates, rebuilding compiled assets and checking package integrity. This process can take 10 to 20 minutes to complete depending on network speeds.
Step 2.5: Restart the cPanel Daemon (cpsrvd)
Once you complete configuration changes and updates, restart the cPanel service daemon to apply the new settings:
systemctl restart cpanelThis restarts cpsrvd, clearing memory caches and serving the updated login templates.
3. Summary of cPanel Theme Issues
| Symptom | Possible Cause | Recommended Action |
|---|---|---|
| Login page unstyled or broken layout | Browser cache conflicts with server assets | Test in private browsing; clear browser cache |
| Fallback to legacy x3 cPanel theme | Incorrect system default theme configuration | Reset system theme to jupiter in /var/cpanel/sysdefaulttheme |
| Interrupted update errors on login | Corrupted or incomplete cPanel system files | Force cPanel update using /usr/local/cpanel/scripts/upcp --force |
Frequently Asked Questions (FAQ)
Will updating the default theme affect my website files?
No. Changing cPanel or WHM default themes only affects the layout of the hosting control panel. Your website files, databases, and mail directories are completely independent and will remain unaffected.
How do I customize the cPanel login page with my company logo?
You can customize cPanel branding in WHM under **cPanel > Customization**. From this interface, you can upload your business logo, favicon, and set custom help links to display on the login page.
What is the current default theme for cPanel?
As of cPanel version 102 and newer, the default cPanel user theme is **Jupiter**. Older themes (like Paper Lantern or x3) have been deprecated and removed from modern cPanel installations.