Official cPanel/WHM Newbie Guide
This guide assumes you already have Cpanel installed and we’ll walk you some of the very basics of using your new Cpanel server. We expect you have some knowledge of what cpanel actually is and know a bit about server administration.
You need to login to your box right well here are a few things to help you. SSL logins are highly recommended for security – please see our Force SSL logins in the Cpanel Tutorials for more details.
Now login to your WHM as the root user.
This is the main section to your web server where you can set the options once and will probably never need to change them.
Main Shared Virtual Host IP:
This is your servers main IP address to be used be default with all shared hosting accounts. This should be setup by default and you probably won’t need to change this unless you want to use a different IP.
Server Contact E-Mail Address:
You will get email alerts sent to this address and make sure you have a decent size inbox for them, something over 2 megs because you will often receive updates, log files and all kinds of other goodies.
Server Contact Pager Address:
Another contact method for receiving special alerts if your server goes down. We recommend leaving this empty and using a third party monitoring service like SiteUptime.com or Alertra.com because if your server is already down, how will it contact you :)
Default cPanel Theme:
The theme you want to be used be default with all new hosting accounts. There are a few to choose from and if you install a custom theme you can enter the name of it here. To see what themes you have installed on the server, scroll down to the left hand size and look for the title: Themes, click on List Installed cPanel Themes.
Alternate Main Ethernet Device:
Don’t touch this unless you’ve setup a custom ethernet configuration.
Default Home Directory:
We recommend setting this to: /home
Home Directory Prefix:
Leave this set to home
Many people get confused about what this is. Basically you make up the prefix in it and apply the main domain used to host your sites to it.
Example: If the main site for the server was test123.com I could set the hostname to server1.test123.com or mars.test123.com The prefix helps you identify which server this is. Make sure to set your hostname properly by using the Change Hostname link at the top left, this should match what you set there.
Apache Access Log Style:
Set this to: combined
There are two options for these depending on what you’re doing.
Option 1) Shared Nameservers – Easiest
This is where you would use your datacentre’s default name servers such as ns1.ev1servers.net and ns2.ev1servers.net
No other configurations are required making this a snap. You would when set all your domain names nameservers, that you want to put on the server , to the same name servers that you entered here.
First off is updates with Cpanel:
Login to WHM (Web Host Manager) and go to, Server Setup/Change Update Preferences:
Right from a programmers hands, this is the first layer of Cpanel that is used for testing, patching etc. It has the latest fixes but isn’t as well tested as other releases.
This is upgraded from the edge release so it has been tested a bit more.
Again another layer of testing, it is older code and has been run on more systems but it takes longer for updates to get to it.
Very old but the most stable version around, it has been tested the longest.
We recommend you set to manual updates, Release option. I prefer manual over automatic because I like to keep a better eye on what has been changed.
If you select manual and you want to perform the update simply scroll down WHM and go to Cpanel > Upgrade To Latest Version.
This will update Exim, scripts, themes, Perl and Cpanel if updates are available – it will only update to the Cpanel release type you selected previously.
To see if new updates are available go to http://layer2.cpanel.net
You can also click on the Change Log at the top of WHM to see their latest updates and releases.
Cpanel and the kernel – use up2date
Cpanel can update your system software – but won’t upgrade your kernel for you, you have to do that with up2date
Note: Don’t upgrade Perl with up2date it will break your Cpanel Perl!
Up2date information can be found here:
Note: You need to use rhn_register before up2date will work!
“You can use the RedHat Network for free by registering from your system (/usr/sbin/rhn_register) and running up2date from there. Then up2date -l will show the list of available updates”
Things to enable:
Things you don’t or shouldn’t really enable:
Configure Backup under WHM:
System Health and running services – eg Apache, Exim etc.
Green = Good | Yellow = Warning | Red = Trouble
Clients can see the service status through their own Cpanel as well.
Things to pay attention to:
- Server Load 0.12 (1 cpu) – the lower the better!
- Memory Used
No one tells you where they are but it’s very important to know
All users have their own seperate log files – every domain has their own logs – eg: sitename.com
Other things to know:
Restart Cpanel in SSH #:
Cpanel Manual Backup & Update – if backup doesn’t work through WHM – SSH command #:
cd /scripts/ then do ./cpbackup
cd /scripts then do ./upcp
Apache Config Test in SSH: -test httpd.conf file for errors!
The configuration file is located in /usr/local/apache/conf/httpd.conf so you may need to edit it in Pico or your favourite editor and make changes.
Manual Stop – Start of services in SSH: (start | stop | restart) #
That’s all I can think of for now! Overall Cpanel is easy to use and has some nice automated features but a control panel can only do so much, you need to get your hands dirty sometimes!