WHM Initial Setup
For WHM version 11.40
To access the WHM interface:
https://IP:2087 in your preferred web browser.
IP with the IP address of your web server.
root as the login name in the Username field.
- Enter your password in the Password field.
- Click Login.
When you log into WHM for the first time, you will see an Initial Setup
screen. This feature helps you configure your server.
Step 1: Agreement
Read the license agreement. Click I Agree/Go To Step 2
Step 2: Setup Networking
This area allows you to define contact information. Required fields are marked with a red asterisk.
Under the Contact Information
- In the Server Contact Email Address field, enter the email address at which you wish to be contacted if your server has a problem.
- To receive email news updates from cPanel, select Subscribe to cPanel News mailing list.
- To receive email updates about new cPanel releases, select Subscribe to cPanel Releases mailing list.
- If you wish to be contacted by text message, enter your phone number in the Server Contact SMS Address field.
- If you wish to be contacted by AIM, select the Server Contact AIM Name checkbox.
- Enter your AIM username into the Server Contact AIM Name field that appears.
- If you do not have an AIM username, you can click the Get a new AIM name link to create an AIM account.
- Enter the AIM username your server will use in the AIM Name to Send Alerts From field.
- Enter the password for the server's AIM username into the Password for that AIM account field.
- If you wish to be contacted by ICQ, select the Server Contact ICQ Number checkbox.
- In the Server Contact ICQ Number field, enter the ICQ number at which you wish to be contacted.
- If you do not yet have an ICQ contact number, click Get a new ICQ number to create a new ICQ account.
- In the ICQ Number to Send Alerts From field, enter the ICQ number your server will use to contact you.
- In the Password for that ICQ account field, enter the password for your server's ICQ account.
Under the Hostname
- Enter your server's hostname in the This Server's Hostname field.
must be a fully qualified domain name (FQDN
). FQDNs are domain names that specify the exact location from the top level user domain to the
domain when read from right to left. This hostname
will require you to use the format
. For example, for the
account on the domain
, you might enter
as the hostname
Resolvers initiate DNS
queries, which allow your server to find and convert human-readable domain names to machine-readable IP addresses. You must configure these resolvers for your server to work correctly. Resolver IP addresses can be obtained through your Internet service provider (ISP).
Under the Resolvers
- Enter a primary resolver IP address into the Primary Resolver field.
- Enter a secondary resolver IP address into the Secondary Resolver field.
Note: The primary and secondary resolvers are required fields.
- If you have a third resolver IP address, enter it into the Third Resolver field.
- While not required, it is a good idea to add an additional resolver. An additional resolver will help ensure your server's uptime if anything happens to either of your other resolvers.
Under the Main Network/Ethernet Device
- Select the device you would like to use for your connection in the Select the main network/Ethernet device menu.
- Click Save & Go to Step 3.
- To return to Step 1, click Go Back.
Step 3: Setup IP Addresses
This area allows you to add IP addresses to your server.
You will need at least one IP address
to function as the primary IP address
of your server. Without this IP address
, visitors will not be able to access your server.
If you wish to skip this step, click Skip This Step and Use Default Settings
To add IP addresses:
- Enter the new IP address(es) into the IP Address(es) to add field.
- You can use CIDR notation to add multiple IP addresses simultaneously. Refer to the Quick CIDR Reference Table on the right for more information.
Remember: When you use CIDR notation, enter the appropriate subnet mask for the range of IP addresses you wish to add.
- Click Add Ip(s).
- If you have already added IP addresses to your server, you can remove any IP addresses not in use. To do so, click Remove in the Current IP Addresses table.
- Click Go to Step 4.
- To return to Step 2, click the Go Back button.
If you intend to use only one IP address
on this server, click the Skip This Step and Use Default Settings
button at the top of the page.
Step 4: Nameservers
This screen allows you to configure nameservers. Nameservers are responsible for spreading your server's DNS
information throughout the Internet. DNS
allows visitors to access websites on your server.
To configure a nameserver
- Select the nameserver software you wish to use. To disable local nameservers, click the corresponding button.
Important: Review the information in the Advantages, Disadvantages, and Notes fields for more information about each option. The BIND nameserver software is adequate for most servers.
Next, choose your nameserver
domains. You must add these at your domain registrar before they will work.
To add nameserver
- Enter the first nameserver into the Nameserver 1 field.
- Most nameservers follow the naming convention
example.com stands for your domain name.
- Enter the second nameserver into the Nameserver 2 field.
- If possible, you should add nameserver domains to the Nameserver 3 and Nameserver 4 fields. If you configure additional nameservers, they will prevent downtime if anything happens to the first two nameservers.
Finally, add A entries
for your nameservers and hostnames. A entries are records on your server that resolve domain names into their corresponding IP addresses.
To add A entries:
- Select the Add "A Entries" for all Nameservers checkbox.
- Enter the IP addresses for each of your nameservers.
- Click Add "A Entries" for Hostname if you wish to add an A entry for your server's hostname.
- If you clicked the Add "A Entries" for Hostname checkbox, enter the IP address for your server.
- Click Save & Go to Step 5.
- To return to Step 3, click Go Back.
Step 5: Services
This screen allows you to configure the services that you and your clients use on the server. To use the default settings, click Skip This Step and Use Default Settings
at the top of the screen.
To configure an FTP
- Select the FTP server software you wish to use, or keep FTP disabled. Review the information in the Advantages, Disadvantages, and Notes fields for more information about each option.
Note: Anonymous FTP defaults to disabled and we do not recommend that you enable it.
To configure a mail server:
- Select the mail server you wish to use, or disable mail. Review the information in the Advantages, Disadvantages, and Notes fields for more information about each option.
- If you switch mail servers: If you wish to preserve settings for each mailbox as you migrate to the new mail server, select the Convert Mailbox Format checkbox. Deselect this checkbox to speed up the migration.
Warning: If you deselect this box, you may lose your email settings.
Finally, select whether you wish to use cPHulk
runs in the background of your server to protect it from brute force
To enable and configure cPHulk
- Click the Enable cPHulk checkbox.
- Select or deselect the checkboxes to determine:
- Whether to extend lockout time for each additional failure past the limit.
- Whether you will receive notifications when cPHulk detects a brute force attack.
- Select the Configure Advanced Settings checkbox to access cPHulk's advanced settings:
- IP Based Brute Force Protection Period in minutes — Specifies the number of minutes to block the IP addresses of potentially malicious users.
- Brute Force Protection Period in minutes — Specifies the number of minutes to lock an account.
- Maximum Failures By Account — Specifies the maximum number of failed authentication attempts allowed by an account.
- Maximum Failures Per IP — Specifies the maximum number of failed authentication attempts allowed by an IP address.
- Maximum Failures Per IP before IP is blocked for two week period — Specifies the number of failed authentication attempts before an IP address is blocked for a two week period.
- Click Save & Go to Step 6.
- Click the Go Back button to return to Step 4: Nameservers.
Step 6: Set Up Quotas
This is the final stage of the Initial Setup
process. You will need to select whether you wish to track disk usage on your server. This is a good idea if you plan to lease server space to individual users. However, if you do not plan to host individual accounts on your server, you may not need to enable quotas.
To set up quotas:
- Select Use file system quotas.
- Remember: This is a good idea if you plan to host individual accounts on your server.
To disable quotas:
- Select Do not use file system quotas.
Remember: This is not a good idea if you plan to host individual accounts on your server.
- Once you have finished, click the Finish Setup Wizard button. You will then be taken to the WHM homepage.
- To return to Step 5, click the Go Back button.