Reset LiteSpeed WebAdmin Console Password (admpass.sh)

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.

Contents

Run the reset script
Log in to verify
Where the credentials live
If the script isn’t there
Frequently asked questions
Related guides
References

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.sh

The 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.

Reset LiteSpeed WebAdmin password — admpass.sh script, login at port 7080, htpasswd file location

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.conf

The 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.sh

OpenLiteSpeed installs use the same script under the same relative path inside their own prefix.

Frequently asked questions

Do I need to restart LiteSpeed after running 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.

What’s the default username and where is it stored?

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.

Is this the same as the cPanel root password?

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.

Where can I find the WebAdmin Console URL?

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.