Knowledgebase : All about cPanel
CPanel is a fully featured web-based control panel that allows you to manage your domain through a web interface. The idea is to transfer as much of the control and responsibility of managing your web site to you. You have the ability to manage all aspec...
The Web / FTP Statistics area presents you with a wide variety of information about your web site, from the latest visitors to a detailed monthly summary of hits, as well as providing an error log. Use the Statistics tools to keep track of what pages are...
The Webalizer tool creates a graphical summary display of usage of your site. This is useful to give you a quick and clear overview of your web site activity. Refer to the home page for more information about Awstats.To use Webalizer:Click on the Webali...
You will want to be able to view your guestbook once visitors start leaving comments. You can keep the guestbook private, or you can set it up so that anyone can view the guestbook.To view the guestbook:Click on the Simple Guestbook link in the CGI ...
You can upload banners whenever new banners need to be added to the rotation. You can specify whether you want the new banners to overwrite the old ones or not.To upload new banners:Click on the Entropy Banner link in the CGI Center area.Click on theAdd B...
You can use File Manager to upload files to your web site, up to 12 files in one go. Although useful, a third-party FTP client has many more features and does not limit you to the number of files you can upload at one time. Refer to the section for mo...
If you are having problems publishing your site using Frontpage, the first test is to uninstall and then reinstall your Frontpage Extensions. If you are still having trouble with Frontpage after that, contact your hosting administrator for help.Note: ...
CPanel enables you to trace the delivery path of an e-mail address, from server to server, to your web site.To trace an e-mail address:Click on the Trace an E-mail Address link in the Mail area.Enter the e-mail address that you want to trace in the ava...
The Trace Route tool allows you to trace the IP (Internet Protocol) route taken by your server to reach your current ISP (Internet Service Provider).To use the Trace Route tool:Click on the Network Tools button on the home page.Click on the Trace Route...
You can view statistics specifically for each subdomain using the Analog and Webalizer tools. Refer to those sections of the Knowledge base articles more information on how to use these tools.To view subdomain statistics:Click on the Subdomain Stats bu...
To add a subdomain (sub.domain.com) on your account, please look for the "subdomain": icon on the main cPanel page. To create a normal subdomain, just enter the name you would like to give this in the box provided (see screen shot). To have this redir...
You can control who can access protected directories by adding authorized users. Generally, at least one authorized user needs to be added, otherwise no-one will not be able to view the directory.To add or modify an authorized user:Click on the Password p...
An FTP account creates a folder on the public_html level of your site that allows external users that know the password to upload and download files from that location. Change your password if you think that your account is being used incorrectly.Not...
You can allow external web servers to access your MySQL databases by adding their domain name to the list of hosts that are able to access databases on your web site. localhost stands for your own web server.To add host access:Click on the MySQL data...
You can redirect Internet traffic from a particular subdomain to another location. This is usually used when the web pages that made up the subdomain have been moved to another location.To add subdomain redirection:Click on the Subdomains button on th...
An addon domain is a domain name that that points to a subdirectory within your account. For example, you may want innovation.org.nz to point to business.org.nz/innovation/. Addon domains must be registered domain names that you own and configured to poi...
The Advanced Guestbook script offers more features than the script by using PHP and a MySQL database.Refer to if you need to manage your Advanced Guestbook after it has been set up.To install the Advanced Guestbook script:Click on the Advanced Gues...
The Analog reporting tool presents a comprehensive coverage of web server statistics available for your web site using CPanel. Refer to the following links for more information about the Analog tool: - All available Analog documentation. - A detailed ...
Apache is an open-source HTTP server, and is used to serve your site. Apache handlers tell the server how to deal with web files that need to be processed on the server. For example, Apache is set up to process files with .pl extensions using Perl. Howev...
Autoresponders are e-mail messages that are sent automatically when an e-mail arrives for a specific e-mail account. Autoresponders are most commonly used for an "Out of Office" style message to inform your correspondents that you are not available, witho...
The Awstats reporting tool combines a comprehensive coverage of web server statistics available for your web site with very attractive reporting pages. Refer to the home page for more information about Awstats.To use Awstats:Click on the Awstats link...
Save the file to disk.Note for Windows users: This file is in .tar.gz format (a GZIP archive file that contains a TAR archive file). This is a common archive format used on Unix machines, in the same way that .zip is a common Windows archive format. Most ...
The Bandwidth tool generates an overall summary of the amount of bandwidth that your site is using. This is generated from HTTP traffic (looking at your web site, downloading files, etc.) and possibly FTP traffic. However, this does not include any ot...
On the main cPanel page, find the "Bulletin Board" icon, and click it. This should lead to a page where you enter details about your new forum, such as where to install, and the admin username and password. Just follow the instructions from there.
This CGI Center area allows you to use some pre-installed CGI scripts through CPanel. This section contains information about using these scripts, as well as using CGI scripts in general.
CGI EMail is a simple, easy-to-use script that takes the results of any form and sends them to you via e-mail. Because it is already installed, minimal configuration is required to successfully use the script.The following steps provide quick summariz...
You need to change authorized user's password if they have forgotten their password or they think someone has access to their account. It is a good idea to regularly change passwords.To change an authorized user's password:Click on the Password prote...
It is useful to occasionally change the passwords on your e-mail accounts to maximize your e-mail security. You should always change your password if you think someone else has access to your account.Note: Make sure that you change the password in your o...
All files on UNIX (including Linux and other UNIX variants) machines have access permissions. These tell the operating system how to deal with requests to access these files. There are three types of access:Read - Denoted as r, files with read access ...
It is a good idea to regularly change your password. You should always change your password if you think someone else has access to your FTP account.To change a password on an FTP account:Click on the Ftp Manager button on the home page.Click on the FTP A...
The Java Clock Maker allows you to create a real-time, dynamic clock, that counts the time just like a digital wrist watch.To create a Java clock:Click on the Clock link in the CGI Center area.Choose the time zone and format for the clock in the Time...
Because Microsoft Outlook Express is the most popular e-mail application available, you can automatically configure Outlook Express from CPanel. This saves time in manually configuring your e-mail application and avoids errors.Note: This will only work i...
You can change how Spam Assassin deals with spam. The following options are available:required_hits - The number of e-mails received before a certain e-mail is considered spam.rewrite_subject - Alter the subject line of spam e-mail. Enter 1 to enable or 0...
You can view and terminate FTP sessions using the provided FTP session controls. This is useful for general information and stopping unwanted FTP activity.To control FTP sessions:Click on the Ftp Manager button on the home page.Click on the FTP Sessi...
The Counter Maker script allows you to create three different items that you can put on your web pages:CounterClockDateCounterThis is a simple counter that displays the number of times a particular web page has been accessed. By putting a counter on ...
Themes are the visual representation of the CPanel user interface - in other words, what CPanel looks like. CPanel has one standard theme:CPanel X - Has a front page that displays all of the central functions with account information on one page. Because ...
You need to create a MySQL user before that user is able to use the database. This does not automatically allow the user to use a database - you need to grant that user permission to the specific database first. Refer to the KB section on "creating a data...
For small text files it can be easier to create them online, rather than on your home computer and uploading the file. You can create text files, such as HTML, PHP, or plain TXT, but not binary files.To create a new file: On the main cPanel page, locate t...
Folders are a very useful way of adding organization and structure to your web site. They make maintenance of the site much easier, as you can easily see what files are in which folder. Most web sites include at least an /image folder to keep all the imag...
Cron jobs are automated actions carried out a predetermined times using the cron program (daemon) on the server. It will read all scheduled jobs from a file, and run them when specified automatically. Find the "Cron Job" icon on the main cPanel page, and...
Deleting an addon domain stops redirecting Internet traffic from a domain to a subdirectory.To delete an addon domain:Click on the Addon Domains button on the home page.Choose the required domain from the Remove Addon Domain drop-down list.Click on th...
You can delete custom Apache handlers at any time. However, you cannot delete system-wide Apache handlers - please contact your hosting administrator if you have a problem with one of these. To delete an Apache handler:Click on the Apache handlers...
Delete an autoresponder when you no longer need to use it. If you use the autoresponder at frequent intervals, such as an "Out of Office" message, you can modify it to point to a nonexistent e-mail account, such as store@yourdomain.com, and then simply ch...
Delete a cron job when you no longer want the command to be automated. If you are unsure what a cron job is doing it is best to write down the "command" portion (exactly as shown), and delete it, then check the code with your hosting administrator. To ...
You can delete an e-mail account when the account is no longer needed. You can not delete your default account.Warning: Make sure you download any mail that you want to keep, as deleting the account will delete all of the mail still in that account immedi...
Delete a spam filter when you no longer need it. There is no way to modify a spam filter - if you have made a mistake, simply delete the filter and start again.To delete a spam filter:Click on the E-mail Filtering link in the Mail area.Click on the Delete...
CPanel's File Manager includes a Trash folder, which operates the same way as the Windows Recycle Bin. All deleted files are automatically placed in the Trash folder and can be restored to their original positions by a simple click. However, once you empt...
Delete a forwarder when you no longer need it. You can not modify an e-mail forwarder - if you have made a mistake, simply delete the forwarder and start again.To delete an e-mail forwarder:Click on the Forwarders link in the Mail area.Click on the Delete...
Deleting an FTP account is as simple as creating as creating the account, but the default account can not be deleted. Deleting the account does not delete the folder or its contents, but it does prevent anyone from accessing that folder through FTP.To del...
You can delete a public or private GPG/PGP key whenever required.To delete a key:Click on the Manage OpenPGP Keys button on the home page.Click on the Delete button next to the key you wish to remove.
Delete a Mailman mailing list when you no longer want the list to be active.Warning: Deleting the mailing list will delete all archives, current mail, and members e-mail addresses. If you want to keep any of this information, be sure to download or ...
You can delete custom MIME types at any time. However, you can not delete system-wide MIME types - please contact your hosting administrator if you have a problem with one of these.To delete a MIME type:Click on the MIME Types button on the home page...
You need to delete a parked domain when you no longer own that domain or when you want to set up a separate web site for the parked domain.To delete a parked domain:Click on the Parked Domains button on the home page.Click on the required domain from ...
Delete a subdomain when you no longer need a separate web presence for that particular part of your web site. Deleting a subdomain does not delete the subdomain folder - you will need to do this manually.To delete a subdomain:Click on the Subdomains b...
Disable hotlink protection when you no longer think that another web site owner is directly linking to your files.To disable hotlink protection:Click on the HotLink Protection button on the home page.Click on the Disable button.
You can disable Spam Assassin whenever you require. If you are not able to receive a non-spam e-mail it may be neccesary to disable Spam Assassin and have the e-mail resent, in order to see if that was the cause.To disable Spam Assassin:Click on the Spam ...
The Disk Usage Viewer enables you to see exactly how much disk space is being taken up by various parts of your web site. Several different viewing options are available: Show Parent Directories - Displays the parent directories as individual items.Sho...
The Domain Lookup tool allows you to look up information about a particular domain. It does this by using a DNS (Domain Name System) lookup, which is a general-purpose replicated, data query service used for translating hostnames into Internet address...
If you have activated the Raw Log Manager, you can download the compressed log files currently available on your web site.To download an archived log file:Click on the Raw Log Manager button on the home page.Click on the required log file and save it ...
Downloading an FTP log is useful for monitoring exactly what FTP actions have occurred on your domain.To download FTP access logs:Click on the Ftp Manager button on the home page.Click on the FTP Accounts link.Click on one of the URLs listed at the bottom...
Modify an autoresponder if you need to alter the details of the message or if you set it to the wrong account.To edit an autoresponder:Click on the Autoresponders link in the Mail area.Click on the Edit button next to the autoresponder that you want to ed...
Editing a pre-existing file through File Manager allows you to make immediate changes to your web site, without having to upload a new version of the file. This is useful for small changes, but would be inefficient for large alterations.To edit a file:Nav...
If you are using Internet Explorer 6 as your web browser you can edit online HTML pages directly through the File Manager.To edit a file using the HTML Editor:Navigate to the folder where the file is located.Click on the name of the file.Click on the...
You can directly edit a key, if ever required.To edit a key:Click on the Manage OpenPGP Keys button on the home page.Click on the Edit button next to the key that you want to edit.Edit the key as required.
There are many different configurable options available with the Mailman script. This procedure shows you how to open up the Administration panel so that you can modify the script options. Use the Mailman documentation that is included in the Adminis...
You can alter the appearance of the search engine template at any time.To edit the search engine template:Click on the Setup Search Engine link in the CGI Center area.Click on the Edit Search Results Template link.Copy and paste any HTML code that ...
You can set up as many POP (Post Office Protocol) e-mail accounts as you require, up to your maximum limit. Each one of these is in the standard e-mail formation of address@yourdomain.com. As with your default e-mail address, you can access these accounts...
You can block an e-mail using spam filters. There are many definitions of spam, but one particularly useful one is the following:Spam is the electronic version of junk mail, and has been around since the Internet was created. E-mail filters are a way of f...
Warning: Make sure you do not need any of the files or folders in the Trash before you empty it, because the files are deleted permanently once the Trash is emptied.To empty the Trash:Click on the Trash button in the Trash area. All of the files in the Tr...
The Entropy Banner script allows you to create a set of revolving banner images, normally used for advertising. You can upload and delete files, set priority on the images, and set URLs to which each image points.To set up an Entropy Banner:Click on ...
This script enables a nice, quick search engine that can help your visitors find information that they are interested in more easily. The larger the site, the more important the search engine becomes.Warning: This search engine searches all of the AS...
The error log contains all HTTP errors that occur when visitors attempt to view your site, such as requested files not found, etc. The Error Log tool is a presentation of the last 300 entries in your error log. A central use of this tool is to locate ...
Error pages are displayed to Internet users when any one of a variety of errors occur, such as when a user enters an incorrect URL or is not authorized to access a specific directory in your web site. Companies often customize error pages to brand them w...
The File Manager allows you to manage your site through HTML, rather than an FTP tool or other third-party application. You can upload, create or delete files, organize files in folders, and change file permissions. While not as sophisticated as most FTP...
Forwards simply allow you to automatically forward e-mail sent to one account to another account. This is useful when you work at two separate locations, or have gone on holiday.To forward mail from one account to two or more accounts, just add two or...
The FTP area deals with all the tools relating to setting up and managing FTP accounts, as well as managing FTP sessions. FTP (File Transfer Protocol) is a method by which you can transfer files between computers, usually using the Internet. There is ...
You can view a variety of information about the server from the home page. The following links are available:Service Status - Displays information about the status of the web services currently running.Installed Perl Modules - Displays a list of Perl modu...
You can generate a backup at any time. This is useful if you have just made some changes to the site and you do not want to have to wait for the routine backup (usually daily or weekly) before downloading the backup.To generate a backup:Click on the ...
Once you have created a user to use a database you need to grant that user permission to use the database. If you have not yet created a user, refer to "creating a mySQL user" in the knowledge base for more information.To grant user permissions to a MySQL...
This is a simple guestbook script that allows you to create a guestbook that your visitors can sign. You can modify the appearance of the guestbook, and view and manage guestbook entries.To create a guestbook:Click on the Simple Guestbook link in the CGI ...
SquirrelMail is a full-featured e-mail application. The text below describes the main buttons in Horde and what they do. This is provided as a summary reference, and not a detailed description of how to use Horde. If you do not know how to use some o...
HotLink protection prevents other websites from directly linking to files on your website. Other sites will still be able to link to any file type that you don't specify below (ie. html files). An example of hotlinking would be using a < img > tag to disp...
You can import a PGP/GPG key directly into CPanel. This will add it to the number of public keys that CPanel trusts.To import a key:Click on the Manage OpenPGP Keys button on the home page.Click on the Import Key link.Cut and paste the key from the anothe...
The Index Manager enables you to control how directories on your web site are displayed. If there is no index.html in a particular directory, the contents of the directory will be displayed to the browser. This is usually undesirable and can cause sec...
CGI (Common Gateway Interface) is a standard for running external programs from a Web server. CGI allows the returned HTML page to be dynamic - for example, with a CGI script you could access information in a database and format the results as part of an ...
The IP Deny Manager enables you to block access to your web site from specific IP addresses. This is useful to remove nuisance surfers who use a large amount of bandwidth or to prevent hotlinking to your site (refer to "hotlinking" in the knowledgebase...
This script creates a Java countdown or countup display, to or from a particular time.Note: This Java applet, while easy to use, is only minimally customizable and does not present very well. Feel free to use the script as long as you understand the...
This quick tool lists the last 300 visitors that have visited your site in the last 24 hours. Note that visitors are defined as requests from servers, not individual people.To view the most recent visitors:Click on the Latest Visitors link in the Web/...
You need to log on in order to use CPanel to manage your web site.To log on:Enter the address of your CPanel in your web browser. The address needs to be in the form of http://www.yourdomain.com:2082 or https://www.yourdomain.com:2083Enter your user na...
You should explicitly log out whenever you have finished using CPanel, as this tells the web server that you have finished that session. If you do not log out, the server automatically closes your session after a set period of time, but there is a sma...
CPanel manages your e-mail through its own mail server. However, by altering your MX (Mail Exchange Record) Entry you can point your e-mail to another mail server, if this is required.Note: CPanel will not be able to manage your e-mail if you change ...
Mailman is a popular mailing list script. Mailing lists are an ideal tool for communication between far-flung participants and can be about anything you want. Mailman allows you to set up a mailing list with a large number of configurable options, suc...
You can manage all aspects of each Advanced Guestbook that has been set up at any time.To manage an Advanced Guestbook:Click on the Advanced Guestbook link in the CGI Center area.Click on the required Guestbook in the Modify an existing Guestbook ar...
You may want to delete entries in your guestbook, either when the page gets too large or if you do not want to keep certain entries. This is easily handled through CPanel.To view the guestbook:Click on the Simple Guestbook link in the CGI Center are...
To add and remove mySQL databases and users, click on the "mySQL databases" icon on the cPanel main page. From here you can create a db (database), as well as users and their associated passwords. CPanel also includes a web-based MySQL management tool ca...
MIME types tell browsers how to handle specific extensions. Most MIME types are set globally on the server. For example, the text/html MIME type equates to htm, html, and shtml extensions on most servers, and this tells your browser to interpret all file...
Refer to the script documentation if you have any questions about modifying or using the shopping cart.To modify an Agora Shopping Cart:Click on the Agora Shopping Cart button on the home page.Click on the required cart underneath the Modify an exis...
You can modify the appearance of your guestbook template at any time.To modify the guestbook template:Click on the Simple Guestbook link in the CGI Center area.Click on the Edit Guestbook Template link.Copy and paste any HTML code that you want int...
Modify the rotation of banners, and change their URLs, as you add and remove banners from your site.To modify banners:Click on the Entropy Banner link in the CGI Center area.Click on the Modify Rotation button.If you need to delete a banner, click ...
Click on the "mySQL databases" icon from the main cPanel page, and on the next page, click "create database". Once this completes, you still need to create a user and password, and add that user into the database before they can make use of it. See "mysql...
NeoMail is fairly self-explanatory. The text below describes the main buttons in NeoMail and what they do. This is provided as a summary reference, and not a detailed description of how to use NeoMail. If you do not know how to use some of the featur...
The Network Tools area has two available functions:Domain Lookup - Allows you to look up information about a particular domain.Trace Route - Allows you to trace the IP (Internet Protocol) route taken by your server to reach your current ISP (Internet Ser...
PhpMyChat is a PHP chat room script that uses a MySQL database to store information. Refer to the home page for more information about this script.To install PhpMyChat:Click on the on the PhpMyChat button on the home page.Enter the directory in which to...
This simple script allows you to insert random pieces of text into your web page. This is useful for daily quotes, helpful hints, or any other place where random text is useful.To install the Random HTML script:Click on the on the Random HTML link in ...
You can download the raw access logs that contain all the recorded hit information that your site has received. These logs are only really useful if you have a preferred reporting tool that you prefer to use, rather than the variety of reporting tools pr...
Raw access logs contain all the recorded hit information that your site has received. You can set the Raw Log Manager to archive this information every month and/or delete the previous month's log at the end of every month. The following options are avai...
You can read your online e-mail using NeoMail, Horde, or SquirrelMail. All of these popular web mail applications allow you to read your e-mail, save them, keep an address book, and perform all of the other basic e-mail functions that you are used to. Th...
You need to rebuild the search engine index whenever you make changes to your site, otherwise the search engine will not be able to find the new material.To rebuild the search indexClick on the Rebuild Search Index link under Entropy Search in the CGI Cen...
Remove authorized users when they no longer should have access to a particular directory. This maintenance task is often forgotten and leaves a hole in your security, so remember to perform this procedure as soon as it is required.To remove an author...
Removing a database will delete that database from its online location. Be sure that you have saved a copy of the database if you want to keep any of the information in the database. Removing a database will not remove any user's but it will remove a...
Remove host access for a particular server when you no longer want that server to access your MySQL databases.To remove host access:Click on the MySQL databases button on the home page.Click on the Delete button next to the web server that you want to rem...
Remove a blocked IP address when you no longer need to prevent access from that IP address.To remove an IP from IP Deny Manager:Click on the IP Deny Manager button on the home page.Click on the required IP address from the Remove an IP Deny drop-down ...
Remove password protection on a directory when you no longer want other users to have access to that directory. You do not need to remove user authorization for the directory when removing password protection, as all the users will be automatically d...
Remove a redirect when you no longer want to redirect Internet traffic from a web page. There is no way to modify a redirect - if you need to change the details of an existing redirect, you need to delete the existing one and start again.To remove a ...
Remove subdomain redirection when you no longer want Internet traffic to be diverted from the subdomain to another location.To remove subdomain redirection:Click on the Subdomains button on the home page.Click on the Remove Redirection button next t...
Removing a user deletes that user - it removes all database permissions that the user has and does not allow that user access to any MySQL databases.To remove a user:Click on the MySQL databases button on the home page.Click on the Delete button next to t...
A user will no longer be able to access a particular database when you have removed their permissions to that database.To remove a user's permissions:Click on the MySQL databases button on the home page.Click on the Delete button next to the specific user...
You can quickly rename a file or folder if you originally labelled a file or folder with the wrong name, or if the name needs to be updated. This is useful if a small number of files need to be changed, since you do not need to upload any files for the ch...
You may need to reset a counter to 0 at some stage, or set the counter number to some other number. This is easily handled in CPanel.To reset your counter:Click on the Counter link in the CGI Center area.Enter the name of the counter in the Counter ...
You can easily restore a deleted file from the Trash by moving it from the Trash to another folder. Restored folders are automatically moved back to their original location. However, you will not be able to restore the item if you have emptied the Trash s...
In the unlikely event that your web site or other files are deleted from your web host's servers, you can restore the web site using your most recent backup file.To restore your web site from a backup file:Click on the Backup button on the home page....
Any e-mail that is sent to an unknown account at your domain name, such as unknown@yourdomain.com, gets automatically rerouted to your default e-mail account. All web site accounts are automatically assigned a default e-mail address - user@yourdomain.co...
The CGI Wrap script creates a scgi-bin folder at the public_html level of your web site. This allows you to run scripts with your own user ID.The advantage of this is that you can run scripts that have the same permissions that you do - you can write,...
Spam Assassin is a mail filter installed on a mail server used to identify spam. It checks for spam using a large number of pre-set rules that check the header, body, and sender of all e-mail messages sent to your domain mailbox. For more information abou...
The Spam Assassin Spam Box is a separate mail folder called "spam". If enabled, all e-mail that Spam Assassin flags as spam is automatically delivered to the "spam" folder.Note: You need an IMAP e-mail client, such as Horde, to view the Spam Box (refer t...
SquirrelMail is a full-featured e-mail application. The text below describes the main buttons in SquirrelMail and what they do. This is provided as a summary reference, and not a detailed description of how to use SquirrelMail. If you do not know how...
THE CGIEMAIL USER GUIDE This guide will help you write a WWW form that sends an e-mail message to you. The following steps are required: * Create an e-mail template. * Put a link to the template on your page. * Decide if a mailto: link will do. ...