How to Create a WHM Reseller Without an Associated Domain

Valid for versions 100 through the latest version

Version:

82

100


Last modified: October 5, 2021

Overview

You can create administrative user accounts in WHM that do not correspond to a cPanel account. These accounts allow a user, such as an employee, to access WHM without root access and perform similar tasks to a root user.

Warning:

If you create a reseller without a domain, certain parts of WHM will not function either when logged in as that user or when you attempt to perform actions which affect that user.

Use the WHM API 1 createacct function to create a WHM reseller account without an associated domain

To quickly and easily create a WHM reseller account without an associated domain, you can use the WHM API 1 createacct function.

  1. Connect to the server via SSH as the root user.

  2. Call the WHM API 1 createacct function. For example:

    whmapi1 createacct username=user password=password reseller_without_domain=1
    Note:
    • In the example above, user represents the desired account username.
    • Make sure you include the reseller_without_domain parameter.

  3. Follow the URL in the output to edit the new account’s privileges. Alternatively, you can edit an account’s privileges using the WHM API 1 setacls function.

    Warning:

    After creating the account using the API, it will not have any privileges added to it. You must add the privileges you want the account to have.

Manually create a WHM reseller account without an associated domain

To manually create a WHM reseller account without an associated domain, perform the following steps:

Note:
In the steps below, username represents the desired account username.
  1. Connect to the server via SSH as the root user.

  2. Create a new user with the following command:

    adduser username 

  3. Set the new user’s password with the following command:

    passwd username

  4. Set the permissions for the new user’s home directory with the following command:

    chmod -v 711 /home/username

  5. Create an entry in the /var/cpanel/resellers file for username with the following command:

    echo "username:" >> /var/cpanel/resellers
    Important:
    Make certain that you follow step 9 and select the desired permissions for this user.

  6. If the /var/cpanel/users/username file exists, open that file with a text editor and remove the following line:

    DNS=

  7. Log in to WHM as the root user and navigate to WHM’s Edit Reseller Nameservers and Privileges interface (WHM >> Home >> Resellers >> Edit Reseller Nameservers and Privileges).

  8. Select username from the menu and click Submit.

  9. Select the checkboxes that correspond to the desired user permissions. Click Save to save these changes.

Change the password for a WHM reseller account without an associated domain

You cannot change the password for this account type using WHM’s Password Modification interface (WHM >> Home >> Account Functions >> Password Modification) or List Accounts interface (WHM >> Home >> Account Information >> List Accounts). The only way to change the password of this account type is using the following command:

passwd username

Remove a WHM reseller account without an associated domain

To remove a WHM reseller account without an associated domain, perform the following steps:

Note:
In the steps below, username represents the account’s username.

  1. Connect to the server via SSH as the root user.

  2. Remove the /var/cpanel/users/username file.

  3. Remove the user file username in the /var/cpanel/users/ directory. To do this, run the following command:

    rm /var/cpanel/users/username

  4. Open the /var/cpanel/resellers file and remove the username user entry from the file.

  5. Remove the user from the system with the following command:

    userdel username

Known limitations for a WHM reseller account without an associated domain

Known limitations for this type of account include, but are not limited to:

  • While logged in to WHM as a reseller account without an associated domain, many activities log a warning in the /usr/local/cpanel/logs/error_log log. Only accounts created manually will generate these warnings. Accounts made using the WHM API 1 createacct function will not generate these warnings.

  • When logged in to WHM as a reseller account without an associated domain, the following interfaces will fail to load correctly:

  • You cannot remove a WHM reseller account without an associated domain via the WHM API 1 removeacct function or WHM’s Terminate Accounts interface (WHM >> Home >> Multi Account Functions >> Terminate Accounts).

  • You cannot change the password for this account type using WHM’s Password Modification interface or List Accounts interface. The only way to change the password of this account type is by using the command line.

Additional Documentation