Page tree
Skip to end of metadata
Go to start of metadata

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 the following tasks:

  • Review bandwidth reports.
  • Reset passwords.
  • Configure mailboxes.
  • Suspend and unsuspend accounts.
  • Manage DNS entries.

Warning:

We strongly recommend that you do not use this method to create administrative user accounts. This method can cause problems with your server configuration.

Create a WHM reseller account without an associated domain

To 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. SSH in to the server 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:all" >> /var/cpanel/resellers

    Warning:

    This command provides the user with root-level permissions. Make certain that you follow step 10 and select the desired permissions for this user.

  6. Create a user file in the /var/cpanel/users directory with the following command:

    cp /var/cpanel/users/system /var/cpanel/users/username
  7. Open the /var/cpanel/users/username file with a text editor and remove the following line:

    DNS=
  8. 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).
  9. Select username from the menu and click Submit.
  10. Select the checkboxes that correspond to the desired user permissions. Click Save to save these changes.

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. SSH in to the server as the root user.
  2. Open the /var/cpanel/users/resellers file and remove username from the file.
  3. Remove the /var/cpanel/users/username file.
  4. Remove the user file username in the /var/cpanel/users/ directory. To do this, run the following command:

    rm /var/cpanel/users/username
  5. Open the /var/cpanel/resellers file and remove the username user entry from the file.

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

    userdel username

Additional documentation