This is an old revision of the document!
If you are new to cPanel, or if this is your first server where you have WHM access, initial setup can sometimes be a little daunting. Here are some tips that can come in handy when first starting out with a new cPanel/WHM server.
There are a few different "services" that are part of cPanel/WHM, and knowing where to go for different actions is important. You can get an overview here and we summarize them a little more below.
WHM is the section where server-level changes are made. Resellers have a restricted access to WHM, but with the "root" user, you can access all of the server-level settings. For more information about the options available in the WHM interface, you can use this page to read about the different sections organized similarly to how they are organized within WHM.
The first time you access WHM, it is likely that the server's hostname does not yet resolve to the server, so you will need to use the IP-based url to access it. If you have a VPS and are not sure of the IP address of your server, you can check it from your My Knownhost page as described here. If you have a Dedicated Server, you will need to refer to your Welcome Email to find your server's IP address. If you are still not sure, you can open a Support Ticket so that we can help you check. For our example, the Primary IP Address of our hypothetical server will be "x.x.x.x"–that means you will need to replace that portion of the url with whatever the IP address of your server is.
So to access WHM the first time, you would need to use a url like this:
Later, once domains exist and resolve to the server, you can begin using those domains instead of the IP addres in the url. But if this is the first time you are accessing WHM, it is not likely that any domains resolve to the server yet.
If this is the first time logging into WHM in this server, the only account that exists so far is "root", so you will need to use that as the username. For the password you will need to use the password for user "root". If you are not sure what it is, you can reset it as described here, if it is a VPS. If it is a Dedicated Server, and you are not sure of the password for user "root", you can open a Support Ticket and we can help you reset it. You can of course also open a Support Ticket if you need help resetting the root password in a VPS, but if you are able to use the password changer in your "My Knownhost" account, that is likely to be faster.
Although in general the default settings are usually acceptable for most usage cases, there are some not-uncommon situations in which some of the settings may need to be adjusted.
There are two settings in WHM at "Home → Server Configuration → Tweak Settings → Domains" which you may want to check.
Here is cPanel's description of the setting "Allow users to park subdomains of the server's hostname":1)
Allow users to park subdomains of the server's hostname
This setting allows users to park subdomains on your server’s main domain.
For example, if your server's main domain name is example.com, click On to redirect user.example.com visitors to that user’s website.
In our VPS template, this is enabled by default, but you may want to consider whether you prefer to leave it set this way. For example, you may want to prevent users from making pages that look more closely associated with you than would be accurate.
Here is cPanel's description of the setting "Allow resellers to create accounts with subdomains of the server’s hostname":2)
Allow resellers to create accounts with subdomains of the server's hostname
This setting allows resellers to create accounts with subdomains of your server’s main domain.
For example, if your main domain name is example.com, enable this setting to redirect user.example.com visitors to the reseller’s website.
In our VPS template, this is disabled by default, but if you have a specific reason you want resellers to be able to make pages like this, it can be enabled. If you need assistance doing so, please feel free to open a Support Ticket.
You may also want to consider enabling "Allow AutoSSL to replace invalid or expiring non-AutoSSL certificates" in AutoSSL. By default, this is disabled, to help prevent an OV or EV certificate from being accidentally replaced by a DV one, but if you have domains that already have certificates from another provider that you would like to start using AutoSSL for instead, you will need to enable this.
In our VPS template, automatic backups are disabled by default, to help prevent you from using up all of the disk space, which can interfere with daemon functionality. However, it is very important to make sure you have reliable backups of anything that you do. To help you with this, WHM has a feature for automatic backups, which we strongly encourage you to use. You will want to make sure when configuring these backups that you will not be causing your server to fully run out of disk space, which can itself result in data loss. You can read more about WHM automatic backups and some of their configuration options here.
The first time you log into WHM, it is very likely that one of the first things you will want to do is to create a cPanel account, so that you can begin setting up the first of your websites. You can read more detail about how to create a cPanel account here.
Within WHM, you can go back to the "Home" screen by clicking the "WHM" in the top left corner. From there, you can navigate to a section by clicking on the section name on one of the buttons in the main section of the Home screen. After clicking a button for one of the sections, there is a page with a button for each of the pages within that section. You can also find any of the pages directly from any of the other pages by using the navigation menu on the left-hand side. If you are not sure what section the page you need is in, you can use the search box above the navigation menu.
For example, the page to create a new account is "Home » Account Functions » Create a New Account". We could simply type "Create a New Account" into the search box, and then that will be the only page listed in the navigation menu until the search is cleared. Or, we can go to the Home screen (if we aren't there already) by clicking the "WHM" in the upper left corner, then clicking the "Account Functions" button, and after that clicking the "Create a New Account" button.
There are many options on this page. For most of them, the "right" setting depends very heavily on what you will need to be able to do with the account. But, here are some tips that will nearly always be applicable:
Once a cPanel account is created, you will then be able to log into cPanel for site-level and domain-level actions. If none of the domains yet resolve to the server, you will need to use an IP-based url like this:
Later, when domains resolve to the server, you can replace the IP address with any of those domains, but if this is the first time you are logging into cPanel in this server, it is not likely that any domains resolve to the server yet.
It is also very common to want to create email accounts within the newly created domain. This is done in cPanel in section Home » Email » Email Accounts. Make sure to remember to use a separate strong password for each account.
Once an email account is created, you can configure a mail client to check your mail.
cPanel also comes with three different Webmail interfaces built-in. You can log into webmail at a url like this:4)
Once there are domains that resolve to the server, you can use the domain instead of the IP address in the url.
Once logged in, you can choose to access Roundcube, Horde, or Squirrelmail, or access configuration settings that are specific to that particular email account.
In order to create a website in a cPanel server, you need to upload the files into the domain's DocumentRoot. For the main domain of a cPanel account, this will usually be
/home/username/public_html (replacing "username" with the username of the cPanel user). If you log into ftp or sftp as the cPanel user, you will start out already in
/home/username, so you would need to change directories into
public_html. If you wish to create additional ftp accounts, the starting directory will depend on the home directory chosen for that ftp user. There is also a File Manager available, or Web Disk can be enabled, if you prefer one of those interfaces instead of ftp.
Depending on the type of site you want to build, and depending on which if any version of Softaculous you have installed, some of these steps might be done automatically when you install the application via Softaculous.
If for now you just need a simple page up, or if you want to make a very simple web page, you can use the Site Publisher now available in cPanel.
You will also want to check the DNS settings of the domain. You may need to check if your main nameservers have been registered. If the new dns settings have not yet propagated, you can still test your site while you wait.
Once one or more domains resolve to your server, you can use them in place of the IP addresses in the urls to access WHM, cPanel, and Webmail. In particular, it is recommended to use the server's hostname for this, so that the name on the https certificate will match the name in the url. For example, if the hostname of the server is "host.example.com", and we have checked that the hostname resolves correctly, we can access WHM with this url:
and cPanel with this url:
and Webmail with this url:
In addition to avoiding browser warnings about the domain not matching the certificate, in recent versions of cPanel/WHM, the certificate used for cPanel, WHM, and Webmail is no longer self-signed, so now we will not get warnings about the certificate being self-signed.