Cpanel Cpanel User manual

cPanel User Manual

iii
Table Of Contents
Using this manual .................................................................................................1
Getting Started......................................................................................................3
Setting your contact information........................................................................3
Overview........................................................................................................3
Steps .............................................................................................................3
Addon domains.....................................................................................................5
Addon Domains.................................................................................................5
Overview........................................................................................................5
Adding Addon Domains.....................................................................................6
Overview........................................................................................................6
Steps .............................................................................................................6
Troubleshooting.............................................................................................7
Removing Addon Domains................................................................................7
Overview........................................................................................................7
Steps .............................................................................................................7
Agora Shopping Cart ............................................................................................9
Overview ...........................................................................................................9
Steps.................................................................................................................9
Troubleshooting.................................................................................................9
Apache Handlers ................................................................................................11
Apache Handlers.............................................................................................11
Overview......................................................................................................11
Adding apache handlers..................................................................................11
Overview......................................................................................................11
Steps ...........................................................................................................12
Troubleshooting...........................................................................................12
Removing Apache Handlers............................................................................12
Overview......................................................................................................12
Steps ...........................................................................................................13
Troubleshooting...........................................................................................13
Backup................................................................................................................15
Backup............................................................................................................15
Overview......................................................................................................15
Generating a full backup .................................................................................16
Overview......................................................................................................16
Steps ...........................................................................................................16
Troubleshooting...........................................................................................17
Download backups..........................................................................................17
Overview......................................................................................................17
Steps ...........................................................................................................17
Download a home directory backup................................................................18
Overview......................................................................................................18
Steps ...........................................................................................................18
Troubleshooting...........................................................................................18

cPanel User Manual
iv
Download a MySQL Database Backup...........................................................18
Overview......................................................................................................18
Steps ...........................................................................................................19
Troubleshooting...........................................................................................19
Downloading an alias or filter ..........................................................................19
Overview......................................................................................................19
Steps ...........................................................................................................19
Restoring backups...........................................................................................20
Overview......................................................................................................20
Steps ...........................................................................................................20
Troubleshooting...........................................................................................20
Bulletin Board .....................................................................................................23
Overview .........................................................................................................23
Steps...............................................................................................................23
Troubleshooting...............................................................................................23
CGI center ..........................................................................................................25
CGI center.......................................................................................................25
Overview......................................................................................................25
Random HTML................................................................................................26
Overview......................................................................................................26
Steps ...........................................................................................................26
Troubleshooting...........................................................................................27
Simple CGI wrapper........................................................................................27
Overview......................................................................................................27
Steps ...........................................................................................................27
Troubleshooting...........................................................................................28
Simple guestbook............................................................................................28
Overview......................................................................................................28
Steps ...........................................................................................................28
Troubleshooting...........................................................................................29
Changing your main password............................................................................31
Overview .........................................................................................................31
Steps...............................................................................................................31
Change Language ..............................................................................................33
Overview .........................................................................................................33
Steps...............................................................................................................33
Adding a chatroom to your site ...........................................................................35
Overview .........................................................................................................35
Steps...............................................................................................................35
Troubleshooting...............................................................................................36
Cron Jobs ...........................................................................................................37
Cron jobs.........................................................................................................37
Overview......................................................................................................37
Adding a cron job in standard mode................................................................38
Overview......................................................................................................38
Steps ...........................................................................................................38

Table Of Contents
v
Troubleshooting...........................................................................................39
Adding a cron job in advanced mode..............................................................39
Overview......................................................................................................39
Steps ...........................................................................................................39
Troubleshooting...........................................................................................40
Deleting a cron job in standard mode..............................................................40
Overview......................................................................................................40
Steps ...........................................................................................................40
Deleting a cron job in advanced mode............................................................40
Overview......................................................................................................40
Steps ...........................................................................................................41
Disk Usage .........................................................................................................43
Disk Usage......................................................................................................43
Overview......................................................................................................43
Disk usage options..........................................................................................43
Overview......................................................................................................43
Steps ...........................................................................................................44
Disk Usage Options:....................................................................................44
Error log..............................................................................................................45
Overview .........................................................................................................45
Steps...............................................................................................................45
Error Pages.........................................................................................................47
Overview .........................................................................................................47
Steps...............................................................................................................47
Troubleshooting...............................................................................................48
File manager.......................................................................................................49
File Manager ...................................................................................................49
Overview......................................................................................................49
Viewing a file's contents..................................................................................50
Overview......................................................................................................50
Steps (click here for a flash demo of this task) ............................................50
Troubleshooting...........................................................................................51
Changing your current directory......................................................................51
Overview......................................................................................................51
Steps ...........................................................................................................51
Troubleshooting...........................................................................................52
Uploading files to your site ..............................................................................52
Overview......................................................................................................52
Steps (click here for a flash demo of this task) ............................................52
Troubleshooting...........................................................................................53
Renaming files.................................................................................................53
Overview......................................................................................................53
Steps ...........................................................................................................54
Troubleshooting...........................................................................................55
Deleting Existing Files.....................................................................................55
Overview......................................................................................................55

cPanel User Manual
vi
Steps ...........................................................................................................55
Troubleshooting...........................................................................................56
Editing a file's contents....................................................................................56
Overview......................................................................................................56
Steps ...........................................................................................................56
Troubleshooting...........................................................................................57
Creating new files............................................................................................58
Overview......................................................................................................58
Steps ...........................................................................................................58
Troubleshooting...........................................................................................59
Copying files....................................................................................................59
Overview......................................................................................................59
Steps ...........................................................................................................59
Troubleshooting...........................................................................................60
Changing a file’s permissions..........................................................................60
Overview......................................................................................................60
Steps (click here for a flash demo of this task) ............................................61
Troubleshooting...........................................................................................62
Moving files .....................................................................................................62
Overview......................................................................................................62
Steps ...........................................................................................................62
Troubleshooting...........................................................................................63
FrontPage extensions.........................................................................................65
FrontPage extensions .....................................................................................65
Overview......................................................................................................65
Installing frontpage extensions........................................................................65
Overview......................................................................................................66
Steps ...........................................................................................................66
Troubleshooting...........................................................................................67
Cleaning up old frontpage extensions.............................................................67
Overview......................................................................................................67
Steps ...........................................................................................................67
Troubleshooting...........................................................................................68
Reinstalling frontpage extensions....................................................................68
Overview......................................................................................................68
Steps ...........................................................................................................68
Troubleshooting...........................................................................................69
Uninstalling frontpage extensions....................................................................69
Overview......................................................................................................69
Steps ...........................................................................................................70
Troubleshooting...........................................................................................70
FTP manager......................................................................................................73
FTP Manager ..................................................................................................73
Overview......................................................................................................73
Adding FTP accounts......................................................................................73
Overview......................................................................................................74

Table Of Contents
vii
Steps ...........................................................................................................74
Troubleshooting...........................................................................................75
Removing FTP accounts.................................................................................75
Overview......................................................................................................75
Steps ...........................................................................................................75
Troubleshooting...........................................................................................76
Controlling FTP sessions ................................................................................76
Overview......................................................................................................76
Steps ...........................................................................................................76
Troubleshooting...........................................................................................77
Anonymous FTP access .................................................................................77
Overview......................................................................................................77
Steps ...........................................................................................................77
Troubleshooting...........................................................................................78
Setting your anonymous FTP message ..........................................................78
Overview......................................................................................................78
Steps ...........................................................................................................78
Troubleshooting...........................................................................................79
Hotlink protection................................................................................................81
Hotlink protection.............................................................................................81
Overview......................................................................................................81
Enabling hotlink protection..............................................................................82
Overview......................................................................................................82
Steps ...........................................................................................................83
Troubleshooting...........................................................................................83
Disabling hotlink protection .............................................................................83
Overview......................................................................................................83
Steps ...........................................................................................................84
Troubleshooting...........................................................................................84
Image Manager...................................................................................................85
Image Manager...............................................................................................85
Overview......................................................................................................85
Thumbnailer ....................................................................................................85
Overview......................................................................................................85
Steps ...........................................................................................................86
Image Scaler...................................................................................................86
Overview......................................................................................................86
Steps ...........................................................................................................86
Troubleshooting...........................................................................................87
Convert Image Format ....................................................................................87
Overview......................................................................................................87
Steps ...........................................................................................................87
Setting up directory indexing...............................................................................89
Overview .........................................................................................................89
Steps...............................................................................................................89
Troubleshooting...............................................................................................90

cPanel User Manual
viii
Interchange Shopping Cart.................................................................................91
Overview .........................................................................................................91
Steps...............................................................................................................91
Troubleshooting...............................................................................................91
Ip deny manager.................................................................................................93
IP deny manager.............................................................................................93
Overview......................................................................................................93
Deny access to your site from a domain or ip .................................................93
Overview......................................................................................................93
Steps ...........................................................................................................94
Troubleshooting...........................................................................................94
Allowing access to denied ip addresses..........................................................94
Overview......................................................................................................95
Steps ...........................................................................................................95
Troubleshooting...........................................................................................95
Leech Protect......................................................................................................97
Overview .........................................................................................................97
Steps...............................................................................................................97
Troubleshooting...............................................................................................97
Mail.....................................................................................................................99
Email...............................................................................................................99
Overview......................................................................................................99
Accessing web mail.......................................................................................100
Overview....................................................................................................100
Steps .........................................................................................................100
Troubleshooting.........................................................................................101
Adding email accounts..................................................................................101
Overview....................................................................................................101
Steps .........................................................................................................101
Troubleshooting.........................................................................................103
Removing email accounts.............................................................................103
Overview....................................................................................................103
Steps .........................................................................................................103
Troubleshooting.........................................................................................104
Changing your default email address............................................................104
Overview....................................................................................................104
Steps .........................................................................................................104
Troubleshooting.........................................................................................105
Creating email autoresponses.......................................................................105
Overview....................................................................................................105
Steps .........................................................................................................105
Troubleshooting.........................................................................................106
Filtering your email........................................................................................107
Overview....................................................................................................107
Steps .........................................................................................................107
Troubleshooting.........................................................................................108

Table Of Contents
ix
Forwarders....................................................................................................108
Overview....................................................................................................108
Steps .........................................................................................................108
Troubleshooting.........................................................................................109
Mailing Lists...................................................................................................109
Overview....................................................................................................109
Steps .........................................................................................................110
Troubleshooting.........................................................................................110
Spam Assassin..............................................................................................110
Overview....................................................................................................111
Steps .........................................................................................................111
Troubleshooting.........................................................................................111
BoxTrapper ...................................................................................................111
BoxTrapper................................................................................................111
Enabling the boxtrapper.............................................................................112
Configuring the boxtrapper........................................................................113
Editing your boxtrapper lists.......................................................................114
Editing your confirmation messages..........................................................115
Reviewing your boxtrapper logs.................................................................116
Reviewing your boxtrapper queue.............................................................117
Tracing an email address..............................................................................118
Overview....................................................................................................118
Steps .........................................................................................................118
Troubleshooting.........................................................................................119
Changing mx entries .....................................................................................119
Overview....................................................................................................119
Steps .........................................................................................................119
Troubleshooting.........................................................................................120
Manage OpenPGP Keys...................................................................................121
Manage OpenPGP Keys...............................................................................121
Overview....................................................................................................121
Adding GnuPG keys......................................................................................121
Overview....................................................................................................121
Steps .........................................................................................................122
Troubleshooting.........................................................................................122
Removing GnuPG keys.................................................................................122
Overview....................................................................................................122
Steps .........................................................................................................122
Mime Types......................................................................................................125
Mime Types...................................................................................................125
Overview....................................................................................................125
Adding mime types........................................................................................125
Overview....................................................................................................125
Steps .........................................................................................................126
Troubleshooting.........................................................................................126
Removing mime types...................................................................................126

cPanel User Manual
x
Overview....................................................................................................126
Steps .........................................................................................................126
Troubleshooting.........................................................................................127
MySQL Databases............................................................................................129
MySQL Databases........................................................................................129
Overview....................................................................................................129
Adding MySQL access hosts ........................................................................130
Overview....................................................................................................130
Steps .........................................................................................................130
Troubleshooting.........................................................................................131
Creating a MySQL database.........................................................................131
Overview....................................................................................................131
Steps .........................................................................................................131
Troubleshooting.........................................................................................131
Creating a MySQL user.................................................................................132
Overview....................................................................................................132
Steps .........................................................................................................132
Troubleshooting.........................................................................................132
Grant a user's permissions to a MySQL database ........................................132
Overview....................................................................................................132
Steps .........................................................................................................133
Troubleshooting.........................................................................................133
phpMyAdmin .................................................................................................133
Overview....................................................................................................133
Steps .........................................................................................................134
Troubleshooting.........................................................................................134
Removing a MySQL database.......................................................................134
Overview....................................................................................................134
Steps .........................................................................................................134
Troubleshooting.........................................................................................134
Removing a MySQL user..............................................................................135
Overview....................................................................................................135
Steps .........................................................................................................135
Network Tools...................................................................................................137
Network Tools ...............................................................................................137
Overview....................................................................................................137
Domain Lookup.............................................................................................137
Overview....................................................................................................137
Steps .........................................................................................................138
Troubleshooting.........................................................................................138
Trace Route...................................................................................................138
Overview....................................................................................................138
Steps .........................................................................................................138
Parked domains................................................................................................141
Parked Domains............................................................................................141
Overview....................................................................................................141

Table Of Contents
xi
Adding parked domains.................................................................................141
Overview....................................................................................................142
Steps .........................................................................................................142
Troubleshooting.........................................................................................142
Removing parked domains............................................................................143
Overview....................................................................................................143
Steps .........................................................................................................143
Password Protect Directories............................................................................145
Overview .......................................................................................................145
Steps.............................................................................................................145
Troubleshooting.............................................................................................145
PhpMyChat.......................................................................................................147
Overview .......................................................................................................147
Steps.............................................................................................................147
Troubleshooting.............................................................................................147
PostgreSQL Databases....................................................................................149
PostgreSQL Databases.................................................................................149
Overview....................................................................................................149
Creating a PostgreSQL database..................................................................150
Overview....................................................................................................150
Steps .........................................................................................................150
Troubleshooting.........................................................................................151
Creating a PostgreSQL user.........................................................................151
Overview....................................................................................................151
Steps .........................................................................................................151
Troubleshooting.........................................................................................151
Grant a user's permissions to a PostgreSQL database.................................152
Overview....................................................................................................152
Steps .........................................................................................................152
Troubleshooting.........................................................................................152
phpPgAdmin..................................................................................................153
Overview....................................................................................................153
Steps .........................................................................................................153
Troubleshooting.........................................................................................153
Removing a PostgreSQL database...............................................................153
Overview....................................................................................................153
Steps .........................................................................................................154
Troubleshooting.........................................................................................154
Removing a PostgreSQL user.......................................................................154
Overview....................................................................................................154
Steps .........................................................................................................154
Raw Access Logs .............................................................................................157
Overview .......................................................................................................157
Steps.............................................................................................................157
Troubleshooting.............................................................................................157
Raw Log Manager.............................................................................................159

cPanel User Manual
xii
Overview .......................................................................................................159
Steps.............................................................................................................159
Troubleshooting.............................................................................................160
Redirects...........................................................................................................161
Redirects.......................................................................................................161
Overview....................................................................................................161
Adding Redirects...........................................................................................162
Overview....................................................................................................162
Steps .........................................................................................................162
Troubleshooting.........................................................................................163
Removing Redirects......................................................................................163
Overview....................................................................................................163
Steps .........................................................................................................163
Scripts Library...................................................................................................165
Overview .......................................................................................................165
Steps.............................................................................................................165
Troubleshooting.............................................................................................166
Search Engine Submit......................................................................................167
Overview .......................................................................................................167
Steps.............................................................................................................167
Troubleshooting.............................................................................................168
SSH / Shell access ...........................................................................................169
Overview .......................................................................................................169
Steps.............................................................................................................169
Troubleshooting.............................................................................................169
SSL Manager....................................................................................................171
Overview .......................................................................................................171
Statistics Software Configuration......................................................................173
Overview .......................................................................................................173
Steps.............................................................................................................173
Subdomains......................................................................................................175
Subdomains..................................................................................................175
Overview....................................................................................................175
Adding subdomains.......................................................................................175
Overview....................................................................................................176
Steps .........................................................................................................176
Troubleshooting.........................................................................................177
Removing subdomains..................................................................................177
Overview....................................................................................................177
Steps .........................................................................................................177
Troubleshooting.........................................................................................178
Subdomain stats...............................................................................................179
Overview .......................................................................................................179
Steps.............................................................................................................179
Submit a Support Request................................................................................181
Overview .......................................................................................................181

Table Of Contents
xiii
Steps.............................................................................................................181
Virus Scan ........................................................................................................183
Overview .......................................................................................................183
Steps.............................................................................................................183
Web / FTP stats................................................................................................185
Web / FTP Stats............................................................................................185
Overview....................................................................................................185
Analog...........................................................................................................185
Overview....................................................................................................186
Steps .........................................................................................................186
Webalizer ......................................................................................................186
Overview....................................................................................................186
Steps .........................................................................................................186
Subdomain stats............................................................................................187
Overview....................................................................................................187
Steps .........................................................................................................187
Latest Visitors................................................................................................187
Overview....................................................................................................187
Steps .........................................................................................................187
Bandwidth .....................................................................................................188
Overview....................................................................................................188
Steps .........................................................................................................188
Error log ........................................................................................................188
Overview....................................................................................................188
Steps .........................................................................................................189
Web Host Manager...........................................................................................191
Overview .......................................................................................................191
Accessing web mail ..........................................................................................193
Overview .......................................................................................................193
Steps.............................................................................................................193
Troubleshooting.............................................................................................194
Index.................................................................................................................195

1
Using this manual
The following manual is designed to familiarize new users with the cPanel
interface and to provide extra knowledge for current users. This manual will focus
on the tasks involved with putting together, and maintaining a web site.
To move from one topic to another, use the list on the left side of your screen.
Click on a topic to reveal the tasks associated with that topic. Click on a task
name to see a description of the task and the steps to accomplish it.
To search for a specific topic that you would like information about, Use either
Index or Search at the top of your screen.

3
Getting Started
Setting your contact information
Overview
Your contact information allows the server or server owner to contact you when
there are any changes to your account.
Steps
1To access Contact Email Address Setup click on Please update your contact
information here. on the main screen of your cPanel interface.
2Enter the email address you wish to be contacted through in the blank field
next to Contact Email:
3Click on Save Email to save this address.

5
Addon domains
Addon Domains
Overview
The Addon Domain Maintenance menu allows you to add and remove addon
domains to your account. An addon domain allows you to reach a subdomain
when entering the name of the addon domain into a browser. his means that you
can host additional domains from your account, if allowed by your hosting
provider. Any current addon domains will be listed under Current Addon
Domains.
For example, if domain2.com is an addon domain on sub.domain.com, going to
http://www.domain2.com in a browser will bring up sub.domain.com
(domain.com/sub).
To access the Addon Domain Maintenance menu, click on the icon above the
words Addon Domains on the main screen of your cPanel interface.
The Addon Domain Maintenance menu in the X2 theme appears as follows:

cPanel User Manual
6
Adding Addon Domains
Overview
The Addon Domain Maintenance menu allows you to add addon domains to your
account. An addon domain allows you to reach a subdomain when entering the
name of the addon domain into a browser. This means that you can host
additional domains from your account, if allowed by your hosting provider.
Steps
1To access the Addon Domain Maintenance menu, click on the icon above
the words Addon Domains on the main screen of your cPanel interface.