Contents

1. Web Hosting ........................................................................................................................................ 2

1.1 Addon Domain Manager ........................................................................................................... 2

1.2 Addon Domain Manager ........................................................................................................... 3

1.3 Backup Wizard .......................................................................................................................... 3

1.4 Cron Jobs ................................................................................................................................... 6

1.5 File Manager ............................................................................................................................. 7

1.6 MySQL ..................................................................................................................................... 12

1.7 Subdomains ............................................................................................................................. 15

1. Web Hosting

1.1 Addon Domain Manager

Create an addon domain

To add an addon domain:

1. Enter the domain for the new addon domain into the New Domain Name field. o Note: When you enter the domain name, cPanel automatically populates the

Subdomain/FTP Username field. If you are creating multiple addons with similar domain names (differing only in .com, .net, etc.), be sure to manually enter a unique username into the Subdomain/FTP Username field.

2. In the Document Root field, enter the directory that will contain the addon domain’s files. 3. Enter the password for the addon domain into the Password field.

o Make sure you use a secure password. o You can have cPanel generate a secure pasword for you using the Generate

Password feature. 4. Confirm the password in the Password (Again) field. 5. Click Add Domain

o Note: Creating an addon domain in the cPanel interface automatically creates a subdomain. Altering or deleting the subdomain after it has been created may affect or delete the information displayed in the addon domain's website.

6. To add files to the addon domain’s home directory, click the File Manager link. o Note: You can also access this addon domain’s home directory in the File Manager

by clicking the link under Document Root.

Note: Web statistics for the addon domain will be found under the subdomain's URL in the

statistics app.

Enable or disable addon domain redirection

To disable or enable redirection of an addon domain:

1. Click the Manage Redirection link corresponding to the addon domain you wish to manage. 2. If you wish to redirect the domain, enter the link you would like to redirect the addon

domain to in the available text field. 3. Click Save.

o To disable the redirect, click Disable Redirection.

Remove an addon domain

To remove an existing addon domain:

1. Click the Remove link corresponding to the addon domain you would like to remove. 2. Confirm that you would like to remove the addon domain by clicking Yes. 3. To keep the addon domain, click No.

Search addon domains

You may also search through existing domains:

1. Enter the search criteria into the Search field. 2. Click Go.

Results matching your search criteria will populate the list.

Addon vs. parked domains

Addon Domains Parked Domains

Main domain appears in the address bar Yes No

Apache directive used VirtualHost ServerAlias

Separate logs Yes No

Separate stats Yes No

Treated as a subdomain (other than URL) Yes No

Ideal for multiple domains sharing the same address No Yes

1.2 Addon Domain Manager

Analog is a program that lets you monitor your website’s traffic. The information is compiled

into months so that it is easier to manage and interpret. Once a monthly log is accessed, the

information is divided into a number of categories and graphs.

To view your Analog stats:

1. Click the button under the View heading next to the desired domain name. 2. Select the month for which you wish to view stats.

Analog opens a new window displaying information about the traffic accessing the domain’s

content.

For more information regarding the Analog application, please visit the Analog website.

1.3 Backup Wizard

The Backup Wizard is a user-friendly interface for creating a backup of the entire site, a

partial backup, or allowing a site restoration from the last backup saved. This tool may be

useful to new users.

Using the Backup Wizard, you can back up and save your entire website or a portion of your

website. You can also use the Restore link to select files to restore portions of your site. To

begin, first select whether you would like to back up or restore your website.

Back up your entire site

To create a full backup:

1. Select Backup from the first page. 2. Select Full Backup from the second page. 3. Select the destination for the backup files. You have 3 options:

o You can store the files in your home directory on your web server by selecting Home Directory from the pull-down menu.

o cPanel can also utilize FTP or SCP to store the files to a remote machine. To do this, fill in the appropriate information and select the method for file transfer from the pull-down menu.

o If you wish to download the file to your computer, skip to the next step. 4. Click Generate Backup.

o If FTP or SCP was used, an email will be sent to the email address that you specified at the beginning of the process.

5. To download a copy of the backup file to your computer, click the filename under Backups Available for Download.

The date the backup was created appears in the filename (which begins with backup-MM-DD-

YYYY). The file will be stored as a “tar ball,” or compressed data file, with the filename

extension .tar.gz.

Note: You cannot use a full backup to restore your site via the cPanel interface. The file must

be downloaded and decompressed prior to restoration. Once the file has been decompressed,

you will be able to upload and restore individual pieces of your website contained within the

full backup.

Create a partial backup

To back up a portion of your site:

1. Select Backup from the first page. 2. Select the portion of your site to back up by clicking Home Directory, MySQL Databases, or

Email Forwarders & Filters. 3. Click the appropriate link or button on the following page to store the required information

to your computer or web server.

Note: The type of the backup file will depend on what portion of your site you are saving to

your computer. For a list of backups and their corresponding file types, see the table below.

Part of Site File Type

Home Directory *.tar.gz

Email Forwarders *.net, *.com

Email Filters *.net, *.com

SQL Database *.sql

Restore a portion of your site

To restore a portion of your site:

1. Select Restore from the first page. 2. Select the portion of your site you would like to restore by clicking Home Directory, MySQL

Databases, or Email Forwarders & Filters. 3. Select the file from your computer that should be used to restore the portion of your

website that you have selected. 4. Click Upload to finish the restoration process.

Note: The type of the backup file will depend on what portion of your site you are restoring.

For a list of backups and their corresponding file types, see the table below.

Part of Site File Type

Home Directory *.tar.gz

Email Forwarders *.net, *.com

Email Filters *.net, *.com

SQL Database *.sql

What's included in my home directory backup?

When you back up your home directory, the backup includes:

All of the files that you own. Files that you do not own but have access to.

Note: Files that you do not own and do not have access to are not included in the backup —

even if they are stored in your home directory.

1.4 Cron Jobs

Cron jobs are scheduled tasks that take place at predefined times or intervals on the server.

Often, a cron job is a series of simple tasks executed from a script file. cPanel offers this

screen as a tool for setting up cron jobs.

Note: Be careful when scheduling cron jobs. Setting them to run too often may slow down

your server.

Adding a cron email

The Cron Email section of this interface allows you to specify an email address at which you

would like to receive notifications whenever your cron jobs are run. To specify an email

address:

1. Enter the email address at which you wish to receive the notifications in the email field. 2. Click the Update Email button.

Adding a cron job

To set up a cron job:

1. Configure the interval at which you wish to run the cron job. o Common Settings — This menu allows you to select a commonly used interval

without having to specify settings for the minute, hour, day, month, and so on. o Minute — Use this drop-down menu to select the number of minutes between

running the cron job, or the minute each hour on which you wish to run the cron job.

o Hour — Use this drop-down menu to select the number of hours between running the cron job, or the hour each day on which you wish to run the cron job.

o Day — Use this drop-down menu to select the number of days between running the cron job, or the day of the month on which you wish to run the cron job.

o Month — Use this drop-down menu to select the number of months between running the cron job, or the month of the year in which you wish to run the cron job.

o Weekday — Use this drop-down menu to select the day(s) of the week on which you wish to run the cron job.

2. In the Command field, type the command you wish the system to run. o Note: If you do not wish to receive an email notifying you of a specific cron job, add

the following line to the command: >/dev/null 2>&1 3. Click Add New Cron Job.

Viewing existing cron jobs

The Current Cron Jobs table displays the cron jobs you have already set up on the server.

From here, you may edit or delete a cron job.

Editing a cron job

To edit a cron job:

1. Locate the cron job you wish to edit. 2. Click Edit. 3. Edit the settings you wish to change. 4. Click Edit Line.

Deleting a cron job

To delete a cron job:

1. Locate the cron job you wish to delete. 2. Click Delete. 3. Confirm that you wish to delete the cron job by clicking Delete again.

1.5 File Manager

File Manager allows cPanel users to manage and edit their files.

The File Manager Directory Selection window

When you open File Manager:

1. The File Manager Directory Selection window will appear. Select which of four main directories you wish to view in the file window when File Manager opens:

o The home directory (/home/user) o Web Root (/public_html/www) o Public FTP Root (/public_ftp) o Document Root (/public_html)

2. If you wish to see hidden files, select the Show Hidden Files checkbox. 3. If you do not wish to see the File Manager Directory Selection window again, select the Skip

this question checkbox. 4. Click Go.

The File Manager interface opens in a new browser window. The selected directory will

display in the file window.

The File Manager toolbar

The File Manager toolbar shows the following functions available to manage your files:

Feature Icon Description

New File

Creates a new file with a user-defined file extension.

New Folder

Creates a new folder in the current directory.

Copy

Copies selected items to a user-specified directory.

Move File

Moves the selected files to a new directory.

Upload

Uploads files to the selected directory.

Download

Downloads selected files to your computer.

Delete

Deletes selected files from the server.

Rename

Renames the selected file or folder.

Edit

Opens the selected files in a text editor.

Code Editor

Opens the selected files in a code editor.

HTML Editor

Opens the selected HTML file in a visual HTML editor. To learn more about

the editor's functions, visit our HTML editor documentation.

Change

Permissions

Changes the read, write, and execute permissions for selected files.

View

Opens the selected file so that you can view the code.

Extract

Extracts the selected *.zip, *.Gz, or *.Bz2 archive and stores the files in a

directory.

Compress

Compresses the selected files to a single *.zip, *.Gz, or *.Bz2 archive and

stores the compressed file in a specified directory.

Notes:

When a toolbar action is not available, the function icon turns gray. Certain File Manager functions are designed for use with only one file at a time. Select the

desired file in the file window before you attempt these actions. Any attempt to Rename, Edit, or View multiple files at once will only affect the first listed file

in the directory.

Character encoding verification dialogs

When you edit a file with Edit, Code Editor, or HTML Editor, a window will appear to

confirm the file's character encoding. Use the menu to select the correct character encoding

for the file. Then, click Edit to continue.

Click Toggle Help to display more information about how to select the correct character encoding.

Click Disable Encoding Check to turn off future verification dialogs.

You can also turn Character Encoding Verification Dialogs on or off through Settings:

1. Click Settings in the top left corner of File Manager. A new window will appear. 2. Enable or disable Character Encoding Verification Dialogs:

o To turn the encoding verification off, select the Disable Character Encoding Verification Dialogs checkbox.

o To turn the encoding verification on, deselect the Disable Character Encoding Verification Dialogs checkbox.

3. Click Save

Warning: If you choose the wrong initial encoding, your file may become corrupt. If your

file displays as a series of special characters, immediately abort the edit and select the correct

encoding. Do not save the file.

Select a directory

You can use the file tree or the location text box to navigate your files and folders.

There are several ways you can use the file tree (located to the left of the file window) to

browse your files:

Click on the name of the folder you wish to view Click on the next to the icon to view a list of subfolders in that folder.

o You can click on the next to an expanded directory to collapse it.

Note: After you expand a list of subfolders, click on the folder name to view the folder's

contents.

To use the location text box directly above the file tree:

1. Enter the path of the folder you wish to view. 2. Click Go. The file window will display the contents of the chosen folder.

The file window

The file window displays the contents of the selected directory. If there are no files or folders

in the selected folder, the file window will display the message "This directory is empty."

Information about files and subfolders will display in the following columns:

Feature Description

File Icon Files will display an icon that corresponds to the file type. Folders will display the

icon.

Name The filename.

Size The size of the file, displayed in bytes, KB, MB, etc.

Last

Modified

The date and time the file was last modified.

Type The media (MIME) type and subtype.

Perms The permissions setting for the file, in octal notation. The default permission setting is

0644.

Note:You can click on a column's heading to sort the file list by that column's value.

The navigation toolbar

You can use the toolbar at the top of the file window to navigate between folders in the file

window.

Feature Description

Home Navigates directly to the home directory (/home/user).

Up One

Level

Navigates to the folder that contains the currently selected folder. This option is greyed

out when the home directory is selected.

Back Returns to the folder that was viewed immediately before the currently selected folder.

Forward Navigates to the next folder that you viewed, after you use Back.

Reload Refreshes the displayed list of files and folders.

Select all Selects all displayed files and folders.

Remember: Any attempt to Rename, Edit, or View multiple files at once will only affect

the first listed file in the directory.

Unselect all Deselects all files and folders currently displayed.

File and folder actions

You can right-click on files or folders in the file window to choose from a menu of actions

customized to the file's type.

Feature Displays for Description

Download Files, Compressed

Files

Downloads the selected file to your computer.

View Files, Compressed

Files

Opens the selected file so you can view the code.

Edit Files Opens the selected files in a text editor.

Code Edit Files Opens the selected files in a code editor.

HTML Edit Files Opens the selected HTML file in a visual HTML editor.

Move Files, Compressed

Files, Folders

Move the selected file or folder to a new directory.

Copy Files, Compressed

Files, Folders

Copies the selected file or folder to a user-specified directory.

Rename Files, Compressed

Files, Folders

Renames a selected file or folder.

Change

Permissions

Files, Compressed

Files, Folders

Allows a user to change the read, write, and execute

permissions for selected files or folders.

Delete Files, Compressed

Files, Folders

Deletes the selected files or folders from the server.

Extract Compressed Files Extracts the selected *.zip, *.Gz, or *.Bz2 archive and stores

the files in a directory.

Compress Files, Compressed

Files, Folders

Compresses the selected files or folders to a single *.zip,

*.Gz, or *.Bz2 archive and stores the compressed file to a

specified directory.

Search for a file

The Search tool, located at the top right corner of the interface, allows users to search for a

specific file. By default, Search will search all files in the home directory. You can also limit

the search to the document root at /home/user/public_html, or to the directory displayed

in the file window.

To search for a file:

1. Use the Search menu to choose the directory to search: All Your Files, only public_html or Current Directory.

2. Enter the desired file name in the text box. 3. Click Go.

A new window displays the filenames that match your search. To go to a folder, or to the

containing folder for a file, double-click on the desired item in the list. If there are no files

that include your search term, you will see the message No records found.

1.6 MySQL

Databases offer a method for managing large amounts of information easily over the web.

They are necessary to run many web-based applications such as bulletin boards, content

management systems, and online retail shops.

Create a Database

To create the database:

1. In the New Database field, type a name for the database. 2. Click Create Database. 3. Click Go Back.

o The new database will appear in the Current Databases table.

Check a Database for Errors

If you are experiencing problems using any database related software you have installed on

the server, you may check your databases for errors.

To check a database:

1. In the Check DB drop-down menu, select the database you wish to check. 2. Click Check DB.

o cPanel will run a script that checks to make sure the database is functional. The results will appear on a new screen.

If cPanel detects a problem in the database, it will indicate which table is corrupted.

If the Check Complete message appears without a notification that the database is corrupted, then the database is functional.

Repair a Database

If you have checked a database and found an error, you will need to repair it.

To repair a database:

1. In the Repair DB drop-down menu, select the database you wish to repair. 2. Click Repair DB. 3. cPanel will run a script that attempts to automatically repair the database.

Note: This will only attempt to repair the database. A repair may not be possible; in this case,

you will be able to locate the source of the corrupt data.

Create a Database User

After you create the database, you will need to add users and their privileges so that the

database can be filled and managed. Please note that MySQL user accounts must be created

separately from mail and web administrator accounts.

To create a new user account:

1. To quickly access the MySQL Users interface, click Jump to MySQL Users. 2. Under Add New User, enter a username. 3. Enter a password in the Password field.

o Note: The password must be 7 letters or shorter. o For help generating a strong password, click the Password Generator button.

4. Retype the password in the Password (Again) field. 5. Click Create User.

Define a User's Privileges

Privileges define how the user is able to interact with the database. For example, they will

determine whether or not the user can add and delete information.

To define a user’s privileges:

1. Under Add User to Database, select a user from the User drop-down menu. 2. From the Database drop-down menu, select the database to which you wish to allow the

user access. 3. Click Add. 4. From the MySQL Account Maintenance screen, select the privileges you wish to grant the

user, or select ALL PRIVILEGES. 5. Click Make Changes.

The Current Databases Table

This table contains a list of databases on your server. For each database, the table displays:

The name of the database. The size of the database.

Users who may manipulate the database. A link allowing you to delete the database.

Search Databases

To search the Current Databases table:

1. Type your criteria in the Search field. 2. Click Go.

The table will display the search results.

Modify a User's Privileges

To modify a user’s privileges for managing a database:

1. Click the user’s name where it appears in the appropriate row. 2. On the MySQL Account Maintenance screen, select the actions you wish to allow the user to

perform, and deselect the actions you wish to prohibit. 3. Click Make Changes.

Remove a User From a Database

To disallow a user from managing a database:

1. Click the icon next to the user you wish to delete in the Current Databases table. 2. If you are sure you want to remove the user’s privileges to manage the database, click Yes.

Delete a Database

To delete a database from the server:

1. Locate the row corresponding to the database you wish to delete in the Current Databases table.

2. Click Delete Database. 3. If you are sure you want to permanently delete the database, click Yes.

Delete a MySQL User

To delete a MySQL user account:

1. Click in the appropriate row of the Current Users table. 2. If you are sure you want to permanently delete the account, click Yes.

To enter new information into a database, you can use the phpMyAdmin client installed with

cPanel. For more information regarding phpMyAdmin visit the phpMyAdmin website

1.7 Subdomains

A subdomain is a subsection of your website that exists as a subdirectory in your

public_html (Document Root) directory. Subdomains use a prefix in conjunction with the

domain name. For example, if the registered domain name was example.com, the subdomain

will be prefix.example.com.

It is important to remember that it takes time for the subdomain to become recognized by

other computers on the web. Visitors will not be able to view your subdomain immediately;

the process takes anywhere from 2 hours to 2 days.

Subdomains can be useful for creating unique user accounts for “vanity domains.” This is

helpful if, for example, you have a blog, or any other type of website that uses a domain

specifically titled for a user.

Add a Subdomain

To create a subdomain:

1. Enter the desired prefix in the Subdomain field. 2. Select the desired main domain from the pull-down menu. 3. Enter the home directory for the subdomain into the Document Root field.

o This directory will be where files pertaining to the subdomain will be placed. 4. Click Create.

Warning: Due to the order in which Apache processes its configuration file, wildcard

subdomains may disrupt the functionality of proxy subdomains. We strongly recommend

that you use wildcard subdomains only when absolutely necessary, or when you do not need

to use proxy subdomains.

To open the subdomain’s main directory with the File Manager:

Click the link under Document Root that corresponds to the subdomain you would like to view in the File Manager.

Search Subdomains

You may also search through existing domains:

1. Enter the search criteria into the Search field. 2. Click Go.

Results matching your search criteria will populate the list.

Modify the document root for a subdomain

To modify the document root for a subdomain:

1. Click the notepad icon corresponding to the subdomain you wish to manage. cPanel displays a new screen.

2. Enter the new file path you would like to use as the document root in the available text field. 3. Click Change.

Enable or disable subdomain redirection

To enable or disable redirection of a subdomain:

1. Click the Manage Redirection link corresponding to the subdomain you wish to manage. cPanel displays a new screen.

2. If you wish to redirect the subdomain, enter the link you would like to redirect the subdomain to in the available text field.

3. Click Save. 4. To disable the redirect, click Disable Redirection.

Remove a subdomain

To remove an existing subdomain:

1. Click the Remove link corresponding to the subdomain you would like to remove. cPanel displays a new screen.

2. Confirm that you would like to remove the subdomain by clicking Yes. 3. To keep the subdomain, click No.