# How to Add a cPanel Server to WHMCS

> Let's take a deeper dive into an essential configuration: how to add a cPanel server to WHMCS so you can start doing business.

- Author: [Ryan Gray](https://www.namehero.com/blog/author/ryan-gray/)
- Published: 2024-09-27
- Updated: 2024-09-27
- Category: [Reseller Hosting](https://www.namehero.com/blog/category/resellers/), [VPS Hosting](https://www.namehero.com/blog/category/vps-hosting/)
- Web page: https://www.namehero.com/blog/how-to-add-a-cpanel-server-to-whmcs/

[![](https://blogcdn.namehero.com/blog/wp-content/uploads/2024/09/26150206/howtoaddcpanelserver-1024x576.jpg)](https://blogcdn.namehero.com/blog/wp-content/uploads/2024/09/26150206/howtoaddcpanelserver.jpg)

In light of our [recent announcement offering a **free WHMCS license**](https://www.namehero.com/blog/get-a-free-whmcs-license-with-nameheros-cloudshield-limited-time-offer/) with select VPS packages, I’ve filmed a tutorial on how quick and easy it is to install WHMCS with just a couple of clicks.

Now, let’s take a deeper dive into an essential configuration: **how to add a cPanel server** to WHMCS so you can start provisioning web hosting services for your customers.
   How to Add a cPanel Server to WHMCS in Minutes: Step-by-Step Guide for Resellers

### **Prerequisites**

Before getting started, make sure you have the following ready:

1. **An active Plus, Turbo, or Business CloudShield VPS**
2. **WHMCS installed and licensed**

While not required, it’s helpful to have an idea of the **packages and pricing** you’ll offer your customers. You can adjust these later as your business evolves, but for this tutorial, we’ll be setting up a basic package.

---

### **Step 1: Access the Server Configuration in WHMCS**

1. **Login to your WHMCS admin area**.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfCiI7ThbqXs7GE4UvkZXcxuleouLd1-S35u0bPzZBvF6J0EpRiej1TN-_Kx5g6MAJ-UtOejFXjplJ-D4QpLSQnyvWD3VA7VoPoccJwIn41BRteknLC3Qy4bhA2-8JvePBfH3sTMzuCTEeMq6ylORoX7xqp?key=E-QNR5p-S5q9lVAy2vEOcQ)

1. **Navigate to System Settings** by clicking the gear icon on the top-right menu.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXd2-7hlcIzwFZb1Dx2B1XtJzyko62MRDl8hm7PY_WoJUgEVhbDR9kyGgDYCCWiSp7jKoZltGML6WvvJvrQ5zpYj1uiXcmyHplCPBjH8wfFFhJtQhzf4pAX_mnJCowvdLSMSJXNpYNPzqwUMT8mCZlpvRfM?key=E-QNR5p-S5q9lVAy2vEOcQ)

1. In the **System Settings** menu, click **Servers**.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfHEQCEmLcbuA2sfrHRDKExc5qUoY-QJ3SYSchtf-4_dKFyEDjIXiBDXNUm4Zm-SllRswywuYCpaRgxT_KredsWJ3rSTpSF3cFMgR1U7Kv91nGaNCddNB6HVQspWfIuKvKt54lfmHONN2QvffjVTkHfwqWz?key=E-QNR5p-S5q9lVAy2vEOcQ)

---

### **Step 2: Create a Server Group**

WHMCS uses **server groups** to organize your servers. These groups help WHMCS decide which servers will handle specific packages. As your business grows, you’ll need to add more groups to accommodate different products and services.

1. Click **Create New Group**.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfRRNVHDphNWfZYtfWRTKycX1iRB8YINamviiUbMRdfvqUEik-LrhI40M6Lwaqc5moFVSIR5nHcgVbZLcn6Uc63uew7Se5IQnsFK2lTbXaLd26ImeS-4HQ1bDVTW9R1cZgIhK6mYttA_Cl9WJEUlQK1b9Af?key=E-QNR5p-S5q9lVAy2vEOcQ)

1. For this demonstration, let’s name the group **Web Hosting**, indicating it will handle standard web hosting accounts. If you plan to offer **Reseller Hosting** in the future, you might create a separate group for that.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcY0Orr1MmQ8wwZDk6IWCaXj_1TYbSqscHaTA-DJsD0Q4squrMXt31MUXEzRcYeoqm3EtawXY_vZ1MTVQzTRAvUU3y3Lp9XXEyDnmvDTXBm72cbYFugJC8zDxkaVnl9ABjjBJ9wHjINEY4olzLx6jxr_Fc?key=E-QNR5p-S5q9lVAy2vEOcQ)

1. Set the **Fill Type** to the default, “Add to the least full server,” to ensure balanced distribution of customers across your servers.
2. **Save Changes**.

At this point, we haven’t added any servers yet, so let’s move on to the next step.

---

### **Step 3: Add a Server**

After creating the server group, you’ll be brought back to the **Servers** page, where you can now **Add New Server**.

1. Click **Add New Server**.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdaCBqaUA88mPeszozChiOq_xz4sJFa83FTQq7KEbRv2ZsuENiTGCoR0ZB2Rotf431rt5o8xiu376i6gT0GAc3TTxaOfvUj0XJPIiy50YoXHVIh7wQTbHVr5Hl3I0buOE6APuPHSuIqlXLRZN6viz_wccFP?key=E-QNR5p-S5q9lVAy2vEOcQ)

1. You will be presented with a form asking for details like **hostname**, **IP address**, and **API token**.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfm7R_9bo62Lejh77ru_yPkCdjne9TMLEtd9N5sMgrOdhL9FK9q372zU0zKmmmFgq4qjUmpP1gXzYEgMQcfceADRYq3iEbNnc-rzsOeD2xgyJ1tkcji4vPhEdrvXfxHmk0lvgb-AX7xoXkn4o-R33ev3B4?key=E-QNR5p-S5q9lVAy2vEOcQ)

To fill this information in, head over to your **NameHero client area** in a new tab.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXf51pwN1anPYMmRwG_gmXy3pAxZsinrc5h4Ma-Gi478Ew7_670xk6_798ORqBbavQK1_dmfffOHD7Hj9mXedFFqPM8pUFfl90bDRDPWYzrMXovtwNwoTDoZEDyMwbI9g8Gpl9_WSdHo_VJJJnpo3acoTiEp?key=E-QNR5p-S5q9lVAy2vEOcQ)

- Find the server’s **Hostname/IP Address** in your client area.
- Click the orange **WHM** logo to log in to **Web Host Manager (WHM)**.
- In WHM, navigate to **Manage API Tokens** and click **Generate Token**.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcjmkVcXz5uO764m8RTrH-n-VHuv44AeTFraiMy6DBg2WkHo0aImVU4Hn1bLafmfjJnPZn6bzQw1YdlfOd0_lSYYvphcWpu3Ieqfus6XAC8cilW5MI4-6IaQWNNo5nOM6KLnLQma_4UvbFqZIKodeKwKu7p?key=E-QNR5p-S5q9lVAy2vEOcQ)

Here’s how to generate the API token:

1. Name the token (e.g., **WHMCS**).
2. Set it to **Never Expire**.
3. Whitelist the IP address of your **CloudShield VPS** (make sure your WHMCS is installed on this server).
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcZJvhlXEdDOD8hY6npw95DyIigKSUig9SEgF1HUb4LUpzyUAba13lZ7L0VoCFxBY5tueBD_qs5Mi9SJhswQ6xrNncxuA1myxRAdTzkhOlzuRZYUwusC1l0Ee4bMLpgvFKAAKMBj62xSD2x-9-u5k-t3MqJ?key=E-QNR5p-S5q9lVAy2vEOcQ)

1. Check the option for **Everything** to ensure WHMCS can perform necessary tasks.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXe0za8CI-BXXWAkgiN0fQbbiFWGCktieQOn1rGWHeQ2Yjfw3RIRDIFuJU8xr6f2EwMESi5i8Y5IWJkOE5iAg9m9FJabJKTFWGwKWpcyKaQWSq_5B-aPrN2VMMAGXm2jnhdwf_x5APbkCZxBepP7L-1HuDpK?key=E-QNR5p-S5q9lVAy2vEOcQ)

1. Click **Save**, then copy the token and store it securely (in a password manager, for example).

Return to WHMCS and enter the following details:

- **Hostname**: Found in your **NameHero client area**.
- **Username**: Use root.
- Leave the **Password** field empty and paste the **API token** you generated earlier.
- Click **Test Connection**.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdGPyWTMMxgbX2VcD1s8z_NwvuoJQfnV8QpDyuEwzBQEBeAL6hVO0dyl48ikNec6pZ8S0wnBzs2RBy3hLZCvB5cZIN3l0WY7HOkiqphdeR0kgrKE7rf1Z7y7yEjERha-AxJqg9bg6111rw5bYo9V2v8Bpcl?key=E-QNR5p-S5q9lVAy2vEOcQ)

If everything is set up correctly, you should see a confirmation message.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXeLqHC-C89g1-e36n-ydZkMVJBfcfkFuQAEWJqDRG4SaI3QrYYfUHg7S63e64YaadwrrAUcWLmTsEO8dLYWkvaTHlXCPHzNKiMw7sPAtphEtL-2Gy8h6re7SgyNy7GtMDkf_lwaGp4OOybpfNSqPfjrf5c?key=E-QNR5p-S5q9lVAy2vEOcQ)

---

### **Step 4: Finalize Server Settings**

Now that the connection is successful, you’ll want to fill in some additional details:

1. **Monthly Cost**: Enter the monthly cost of the server (e.g., $67.57 for this example). This helps track your expenses and profits in WHMCS.
2. **Datacenter/NOC**: Specify where the server is located.
3. **Number of Accounts**: WHMCS sets the default to 200 accounts, but feel free to adjust this based on the number of clients you anticipate.

For the **Nameservers**, WHMCS will auto-populate the fields. If you’re not familiar with these settings, it’s best to leave them as they are.

The **SSO Access Control** allows administrators in WHMCS to use Single Sign-On (SSO) to access the server. In most cases, leaving the default settings here is fine.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXf4YncFSrvoKIm7bezioaR-N3djbWCe0Zl5eYe1NFFWZIwp19kORPJlU-e7HD-rUvslOHdaDJTx4BWXsa2DC7s9FtAoMP9Xa3e7y-VYba4vhN1aUi924tIcVInpXsl100AWkm3D2cbXb88Uf2h2_NU6Qo8?key=E-QNR5p-S5q9lVAy2vEOcQ)

Finally, click **Save Changes** to complete the server setup.
 ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcUWAXnXforHr3E9NXRMeQQjIZjOtuGVCRjdcgpDYWRG7jVDRoHm47oP6BXCGyatWQdWnoEzq_MmDXIm8bcVxUT-BkvSDxSb86jH5fZ5rTEmN-VZoX0k2MeBYjuce8UJcfvCXEW6ibnPctDuuQp-8vTs9b6?key=E-QNR5p-S5q9lVAy2vEOcQ)

---

### **Congratulations! You’re Ready to Start Selling**

You’ve successfully added your first cPanel server to WHMCS! Now, you can create web hosting packages and start provisioning accounts for your customers.

In my next tutorial, I’ll cover how to set up packages, so you can start bringing customers on board and manage their services seamlessly.

Stay tuned!

---

## Related posts

- [How To Enable HTTP/2 On Your cPanel Virtual Private Server (VPS)](https://www.namehero.com/blog/enable-http2-cpanel-virtual-private-server-vps/)
- [How To Add A Public Key To Your Server Without SSH](https://www.namehero.com/blog/how-to-add-a-public-key-to-your-server-without-ssh/)
- [How To Install Blesta On Your Web Server via cPanel (2024)](https://www.namehero.com/blog/how-to-install-blesta-on-your-server/)
- [How To Change Your PHP Version And Add Extensions Inside cPanel](https://www.namehero.com/blog/change-php-version-add-extensions/)
