To reset the LiteSpeed WebAdmin Console password on cPanel (or any LiteSpeed install), SSH in as root and run the bundled admpass.sh script. It prompts for a new username and password and writes them immediately — no service restart needed.
Last verified: 2026-05-17 on LiteSpeed Web Server 6.2 + cPanel. Originally published 2023-12-14, rewritten and updated 2026-05-17.
Run the reset script
sudo /usr/local/lsws/admin/misc/admpass.shThe script prompts:
Please specify the user name of administrator.
This is the user name required to login the administration Web interface.
User name [admin]: # press Enter to keep "admin"
Please specify the administrator's password.
Password: # type your new password (hidden)
Retype password:
Administrator's username/password is updated successfully!The change is immediate — you can log in to the console with the new password right away.
Log in to verify
https://your-server-ip:7080/The default LiteSpeed WebAdmin port is 7080 over HTTPS. The cert is self-signed by default, so accept the browser warning or set up a reverse proxy on a real domain.
Where the credentials live
# Credentials file (don't edit by hand)
/usr/local/lsws/admin/conf/htpasswd
# WebAdmin configuration
/usr/local/lsws/admin/conf/admin_config.confThe password is stored as a salted hash in htpasswd. Editing the file directly works in theory (LiteSpeed accepts standard Apache htpasswd hashes) but admpass.sh is the supported path — it generates the right hash format automatically.
If the script isn’t there
Some custom LiteSpeed installs use a different prefix. Search for the script:
sudo find /usr/local -name 'admpass.sh' 2>/dev/null
# Typical location: /usr/local/lsws/admin/misc/admpass.shOpenLiteSpeed installs use the same script under the same relative path inside their own prefix.
Frequently asked questions
admpass.sh? No — the script writes the new credentials immediately to disk, and the WebAdmin Console reads them on each login. No service restart needed. The change takes effect on your next login attempt.
The default is admin. Credentials live in /usr/local/lsws/admin/conf/htpasswd as a salted hash. admpass.sh is the supported way to update them — editing the file by hand requires generating a compatible hash and rarely worth the effort.
No, completely separate accounts. The LiteSpeed WebAdmin Console password controls access to LiteSpeed-specific server tuning (graceful restart, configuration reload, virtual hosts) at https://your-server:7080. It’s unrelated to your cPanel root login, WHM credentials, or SSH key-based access.
Default port is 7080 over HTTPS — https://your-server-ip:7080/. The cert is self-signed by default, so browsers warn. For production access, set up a reverse proxy on a real subdomain (e.g. lsws.example.com) with a Let’s Encrypt cert, then restrict that subdomain to your office IP with firewall rules.
Related guides
- How to Switch from LiteSpeed to Apache in WHM/cPanel
- How to Fix Quotas in cPanel
- How to Retrieve the MySQL Root Password in aaPanel
References
cPanel knowledge base: support.cpanel.net (LiteSpeed WebAdmin password reset). LiteSpeed admin guide: docs.litespeedtech.com/lsws.
