A domainless WHM reseller account gives a staff member selected WHM permissions without creating a hosted website for that account. This guide explains how a server administrator can create it and assign the required privileges.
Before you start
You need root SSH and WHM access. Choose an unused username and decide which permissions the person needs. This account type has limitations: it has no contact email or normal account email notifications, cannot be backed up with pkgacct, and does not support every WHM interface.
Create the account
-
Connect to the cPanel server through SSH as root.
-
Run the following command, replacing both placeholders. Use a strong, unique password and handle the command and its output as sensitive information:
whmapi1 createacct username=staffwhm password='REPLACE_WITH_A_STRONG_UNIQUE_PASSWORD' reseller_without_domain=1 -
Check the API result for success before continuing.
-
Follow the privileges link in the result, or open WHM > Resellers > Edit Reseller Nameservers and Privileges and select the new username.
-
Select only the required privileges and click Save. The newly created account has no assigned privileges until you add them.
-
If you will use WHM API calls for the account, run cPanel’s account-domain mapping update first:
/usr/local/cpanel/scripts/updateuserdomains -
Test the new WHM login and confirm that its permissions match the intended role.
Change its password later
WHM’s normal account password screens do not support this account type. A root administrator can change the password interactively using:
passwd staffwhmReplace staffwhm with the account’s actual username.