You are on page 1of 194

cPanel Guide 11.

34

(C) 2012 Surpass Hosting

cPanel Guide 11.34
1

Hosting Info
1.1

2

4

5

6

What's New
2.1

3

Surpass Hosting, Your Hosting Partner

What's New in cPanel 11.34

9

Welcome to cPanel
3.1

Logging into cPanel

12

3.2

Welcome to cPanel

14

cPanel Preferences
4.1

Getting Help in cPanel: Wizards and Tutorials

20

4.2

Changing your Contact Information

22

4.3

Customizing cPanel

24

4.4

Bookmark cPanel

26

Working with E-mail
5.1

Creating New E-mail Accounts

28

5.2

Configuring E-mail Clients

31

5.3

Modify Existing E-mail Accounts

35

5.4

Working with Webmail

38

5.5

Combatting Spam

42

5.6

Mail Forwarders

48

5.7

E-mail Autoresponders

52

5.8

Handling Unrouted E-mail

55

5.9

Setting up Mailing Lists

57

5.10 Server-side E-mail Filtering

59

5.11 Testing E-mail Routing

63

6

7

8

9

5.12 Importing E-mail Accounts and Settings

66

5.13 Combat E-mail Spoofing

68

5.14 Changing MX Records

72

Working with Files
6.1

Backing up and Restoring Data

77

6.2

The cPanel File Manager

83

6.3

Using WebDAV (Web Disk)

91

6.4

Monitoring Disk Space Usage

95

6.5

File Transfer Protocol (FTP)

97

Web Logs and Statistics
7.1

The Latest Visitors Log

105

7.2

Bandwidth Useage Logs

107

7.3

Web Stats

109

7.4

Raw (Unprocessed) Web Logs

111

7.5

Account Error Log

113

Security
8.1

Password Protected Directories

115

8.2

Deny Website Access by IP Address

117

8.3

SSH (Shell) Access

119

8.4

Hotlink Protection

125

8.5

Stop People from Sharing Account Information to your Site

128

8.6

Mail Encryption with GnuPG

132

Managing your Domains
9.1

Subdomains

136

9.2

Addon Domains

139

9.3

Parked Domains

143

3 Enabling Remote MySQL Access 159 Software and Services 11.1 Apache Handlers 176 12.7 MIME Types 191 Closing 13.4 Domain Redirection 145 9.1 CGI Software 162 11.2 Add/Remove Software 163 11.6 Network Tools 189 12.6 Softaculous 172 Advanced Features 12.1 Final Thoughts 194 .3 Perl Modules 165 11.5 Cron Jobs 184 12.4 PHP Modules and Settings 167 11.2 PHPMyAdmin 157 10.1 Working with MySQL Databases 152 10.10 11 12 13 9.5 Fantastico 169 11.4 Custom Error Pages 182 12.2 Image Management 178 12.3 Web Index Management 180 12.5 Simple DNS Zone Changes 148 Databases 10.

34 .5 (C) 2012 Surpass Hosting .Hosting Info cPanel Guide 11.

Alternately. pay bills or request support. please feel free to contact us. If you are a long-time HostDime customer (as many of you are).surpasshosting.com/ Enter your CORE username and password and you can submit a support request directly to us.34 . It includes your CORE account access information.surpasshosting. day or night. you can submit a request for assistance via our Concierge Live Assistant system at any time. Don't lose that e-mail. your CORE account information was sent to your separately when the new system was rolled out. one-stop shop to learn about all of the many great features that cPanel and Surpass Hosting offer you. When you signed up with us you received an e-mail with important account information. Your Hosting Partner Learn how to submit support requests. then enter the requested cPanel Guide 11. so if you are looking for information on a specific feature. If you have any questions or have any sales or support queries.6 (C) 2012 Surpass Hosting . any time. We look forward to serving your hosting needs for years to come.com/ and click on the Concierge Live Assistant link at the top of the page. To do so.Surpass Hosting. go to: http://www. just scroll down the guide until you come to the section you are looking for. Hosting Info . CORE is your central account management and support portal that helps you manage all of the services you have with us. We are here for you. It is organized the same way features in your cPanel account are. This guide is your complete. Just log into your CORE account at: https://core.com We at Surpass Hosting would like to thank you for choosing to host with us.HostDime.

cPanel Guide 11. some types of requests cannot be handled via Concierge Live Assistant without verification of certain private details or confirmation via support ticket.34 .7 (C) 2012 Surpass Hosting .details. NOTE: For security.

What's New cPanel Guide 11.8 (C) 2012 Surpass Hosting .34 .

What's New in cPanel 11.34
Learn about the new features in cPanel 11.34

cPanel 11.34: Improved WebDAV and Email Setup

If you're already familiar with cPanel and what it offers, then this section is for you.
If not, skip to the next section of the guide.
cPanel 11.34 has a few new features for cPanel users (and a lot of "changes under the hood").
The key new features are:

cPanel Guide 11.34 - 9

(C) 2012 Surpass Hosting

• Improved WebDAV (Web Disk) support: cPanel now provides scripts or directions that make it
easy to mount your account via WebDAV (including Windows 7 and 8 and most mobile platforms).
• Improved e-mail account setup: cPanel makes it easier to set up email accounts on your desktop
machine. There are autoconfigure scripts for a wider variety of email clients.

cPanel Guide 11.34 - 10

(C) 2012 Surpass Hosting

Welcome to cPanel

cPanel Guide 11.34 - 11

(C) 2012 Surpass Hosting

However.com:2082/ NOTE: The addresses that start with "https://" will connect to cPanel in a secure way that will help make sure that no malicious third-party could be looking at what you are doing (unless they have access to your actual computer. Firefox 7 or 8.Logging into cPanel Learn how to log into cPanel Working with Your New Website To manage the various features of your new website you will need to log into a special web-based control panel (called cPanel). Also.com/cpanel http://yourdomain. https://yourdomain.com/cpanel https://yourdomain. cPanel works well in nearly any modern web browser on any computing platform.com:2083/ http://yourdomain. you probably won't receive another warning about it when you log into your web-based control panel (just referred to as cPanel from now on) in the future unless the certificate changes or you log in from another browser or computer. Internet Explorer 7 or 8.34 . Please note: Replace "yourdomain. Some older browsers like Internet Explorer 6 or AOL's web browser may not work as well with cPanel.12 (C) 2012 Surpass Hosting . It is preferable that you use this more secure method.com" with your domain name. you need to start your web browser on your computer. Please update your web browser if needed. it is OK to click YES or CONTINUE or ACCEPT (whatever your browser shows to let you accept this certificate). please be aware that your web browser might pop up a warning telling you that the security certificate (SSL certificate) cannot be recognized and so might not be valid. For example. No matter which address you enter into your web browser. Load your web browser and then type one of the following items into your web browser (they will all take you to the same place). if you accept the certificate. Even though you may get this warning. To do that. If you do get this. of course). you will be prompted for your account cPanel Guide 11. the connection to your web-based control panel is still secure so long as you accept the certificate. Safari and Opera (and all newer versions of those browsers) will work OK.

cPanel Guide 11. Your cPanel username and password were provided to you when you signed up for an account. Please retain this information in a safe and secure location! The username is not case sensitive. the system may block you and you'll need to contact us to gain access to your account again. but the password is case sensitive.username and password. Be careful when typing. If you type in the wrong username and password too many times.34 .13 (C) 2012 Surpass Hosting .

14 (C) 2012 Surpass Hosting .Welcome to cPanel The main cPanel home screen and features. cPanel Guide 11.34 .

You certainly can do this if you wish and cPanel will walk you cPanel Guide 11.15 (C) 2012 Surpass Hosting . you will see a screen similar to the one above. Note that the first time you log in. you will probably see another popup that asks if you want to go through the tutorials or not.34 .Getting to Know cPanel Once you successfully log into your cPanel account.

cPanel will keep track of which features you access most often and insert a box in the sidebar with text links to those commonly used features. The sidebar will show you commonly used information as well as tell you how much of your available disk space you are using.through some common tasks and explain more to you about how web hosting works. However. you can safely skip the tutorials for now." Clicking HELP will bring up a new window with explanations of the various features you will find in cPanel. cPanel Guide 11. Type a word or two about the feature you are looking for. and the features that match what you've typed will be highlighted to the right. since you are reading this document.16 (C) 2012 Surpass Hosting . etc. The list will change over time so it always reflects your most used features. On the right side." Clicking this from whatever screen you are on will instantly take you back to the screen pictured above (the home screen). Once you start clicking on features. You can always go through the tutorials at any time later by clicking on the Getting Started Wizard option at the top of your cPanel (see the step below). the exact feature set you have may vary. Be sure to check the "do not show this again" check box in the popup before clicking on YES or NO unless you want to see that popup again. you can use the (6) FIND feature in the sidebar. On the right side you will see links for (2) "Help" and (3) "Logout. Under that. We will discuss each of the available features in-depth a bit later. NOTE: If you ever need to find a particular feature in your cPanel account later and you cannot remember where it is. on the left side is a (4) sidebar that contains information about both your website and the server that your website is hosted on. taking up most of the screen are (5) several boxes with links to the various features of your web hosting account. NOTE: The screenshots in this document show a demo account. how many databases or domains you are using (out of your total). This means you won't have to search around looking for features you use all the time.34 . LOGOUT will log you out of cPanel and offer to let you log in again. At the top of the screen you will see a link on the left called (1) "Home. One feature in the sidebar that is not visible in the screenshot above is account shortcuts.

cPanel Guide 11.34 . Part 2 This screenshot shows the bottom half of your cPanel home screen.17 (C) 2012 Surpass Hosting . Note the two rows of text links at the bottom.Welcome to cPanel.

. If you want to expand each box you've collapsed. The first item. cPanel Guide 11. For example if you want to move the Advanced box up so it appears before the Domains box. We'll discuss each feature in the order that they appear on cPanel's home screen. If you ever want to reset the order of the boxes back to their original positions.(1) This row of links helps you modify your cPanel home screen. a link to basic cPanel help. another link to log out of your cPanel account." You can also move the boxes of features around by dragging their title bars up and down and then dropping the box where you want it to be. "Lite Grahpics" will reduce the size and amount of graphics you see in cPanel. click "Reset Box Order. just drag the title bar up to the space between Security and Domains and then let go.18 (C) 2012 Surpass Hosting .34 ." (2) At the very bottom of the screen. a more detailed "Documentation" link that will go into more detail about cPanel and finally. there are text links that will bring you back to the cPanel home screen. "Reset All Interface Settings" will reset any changes you've made to the cPanel interface and put things back so they look similar to the screenshots above. Now let's take a look at the features your web hosting account comes with. Again. a link that will take you to a page showing you the various trademarks owned by cPanel Inc. This will make cPanel load faster if you have a slow Internet connection. remove the small pictures above each feature and leave only the text links to those features. this will improve the loading of cPanel if you have a slow Internet connection. You can collapse the boxes containing features by clicking on the small arrow to the right of each box in the title bar (3). "Hide Icons" will do just that. just click the fourth link in this row "reveal all boxes. The second item.

34 .19 (C) 2012 Surpass Hosting .cPanel Preferences cPanel Guide 11.

Getting Help in cPanel: Getting Started Wizard There are several ways to get help with your cPanel account. how to access your web hosting account and how to put files in your account. All of these features are available separately on the cPanel home screen. cPanel Guide 11. It also explains more about how web hosting works. The Getting Started Wizard will walk you through the most common things most people want to do the first time they access cPanel. setting up e-mail accounts. so you shouldn't feel like you have to follow the wizard if you don't want to. changing your cPanel password. This wizard will take you step-by-step through setting the default language in cPanel (pictured above). NOTE: You can jump to other steps in the wizard by selecting them from the (1) drop-down box on the right and then clicking GO.20 (C) 2012 Surpass Hosting . etc. The first two features in the Preferences box on the cPanel home screen are two more ways. some of which we already discussed.Getting Help in cPanel: Wizards and Tutorials cPanel walks you through basic account setup features.34 .

21 (C) 2012 Surpass Hosting . choose the low quality link. Each video has a high and low quality version. but you can view a number of easy step-by-step videos just by clicking on Video Tutorials on cPanel's home screen.Getting Help in cPanel: Video Tutorials Not only is there text-based help in cPanel. This will take you to the page presented above where you can learn how to do each of the tasks listed. click the High quality link to learn how to do the tasks listed. Otherwise. If you have a slow computer or Internet connection. cPanel Guide 11.34 .

In order to ensure you get these notifications. cPanel Guide 11. Stay in the Know: Update Contact Information cPanel has the ability to send you an e-mail when certain important things happen (or are about to happen) with your hosting account. you need to tell cPanel how to get in touch with you.Changing your Contact Information Make sure you update your contact information so your hosting account can contact you if there are issues you should deal with. Enter at least one valid e-mail address into the appropriate box. you will see a screen similar to the one above. You can set up your notification preferences by clicking on the Update Contact Information item on the cPanel home screen.34 .22 (C) 2012 Surpass Hosting . check or uncheck items that you do or do not want to receive e-mails about and click the SAVE button. When you do.

Also. an e-mail address that doesn't end in @yourdomain. keep in mind that if you enter two e-mail addresses then both e-mail accounts will receive e-mail from your cPanel account at the same time.com). cPanel Guide 11. it is only used by the server itself to send you important automated information..23 (C) 2012 Surpass Hosting . Adding your contact details here does not send subscribe you to any third-party mailing lists nor does it update or change your details in CORE.34 .e. you will still be able to receive warning e-mails at another address. The reason for this is if there is a problem with the server or your hosting account.NOTE: It is highly recommended that you enter at least one e-mail address and that at least one e-mail address not be hosted on this server (i.

Customizing cPanel Learn how to change the way cPanel looks or the language it uses. cPanel Guide 11. You will be presented with thumbnails of several different styles you can choose. Your new style will take effect immediately. Choose the radio button under the style you want to use and click the CHANGE STYLE button.24 (C) 2012 Surpass Hosting . To try a different theme.34 . click Change Style on the cPanel home screen. NOTE: [root] is the default style of cPanel's theme (the one demonstrated in these screen shots). Customizing cPanel: Changing the Style of cPanel's Default Theme If you are not happy with how your cPanel looks. you have a wide variety of choices for changing it.

then the English translation will be used. Simply select a language from the list and click CHANGE to switch to that language. cPanel Guide 11. so future updates to cPanel may add/remove/update the available languages. NOTE: Not all languages available in cPanel are full and complete translations. cPanel Inc.34 . If the chosen language file does not have a translation for an item in cPanel.Customizing cPanel: Change the default Language If you click on Change Language on the cPanel home screen. you can select from several different languages. maintains the language files.25 (C) 2012 Surpass Hosting .

Bookmark cPanel Learn how to add a bookmark to cPanel in your web browser.26 (C) 2012 Surpass Hosting .34 . From there you can select the saved bookmark to go directly to your cPanel account or webmail. Make it Easy to Access cPanel Features: cPanel Bookmark Shortcuts cPanel makes it easy to add your web hosting account as a bookmark in your browser so you can easily access it again later. cPanel Guide 11. Click on Shortcuts on the cPanel home screen and then drag one or both of the two displayed links into your browser's bookmark or favorites menu or tool bar.

27 (C) 2012 Surpass Hosting .34 .Working with E-mail cPanel Guide 11.

We'll discuss the individual features in this chapter.Creating New E-mail Accounts Learn how to create new e-mail accounts. If you want to look more professional. These e-mail accounts will all end in @yourdomain. All e-mail related features can be found in the Mail section on the cPanel home screen. you should only use e-mail accounts that end in your domain name (yourdomain.com. Working with Mail in cPanel cPanel offers you the ability to create and manage unlimited e-mail accounts.28 (C) 2012 Surpass Hosting . cPanel Guide 11.34 .com) for business because that makes you look more professional than using an e-mail address from AOL or YAHOO for business.

To create a new e-mail account. Type the password you want the new account to have into the (2) "Password:" and "Password (Again):" fields. Your account permits you to create as many e-mail accounts as you need.Creating E-mail Accounts To create or manage e-mail accounts.29 (C) 2012 Surpass Hosting . click on Email Accounts on the cPanel home screen. you can select the domain from the drop-down box after the "@" (at) symbol.34 . The "Password Strength" cPanel Guide 11. enter the details into the grey box at the top of the screen where it says "Add a New Email Account" Type the username of the new account into the field next to the word (1) "Email:" and if you have more than one domain added on or parked on your hosting account.

cPanel Guide 11. the account won't be able to receive more mail if it hits that quota or if your web hosting account is out of disk space (whichever comes first). By default. but you can change it or remove the number altogether if you don't want the account to have a quota and then click (4) CREATE ACCOUNT to create the new account. A longer bar means your password is more secure. if you prefer. Finally. the number is set to 250 MB of disk space. NOTE: Mail does count towards the storage limits on your web hosting account and if you do not specify any mailbox quota (if you leave the field blank) then the new account won't have any disk space limits to store mail. At that point you wouldn't receive any new e-mail or be able to store any more files in your web hosting account.meter will fill up as you type your password. If you do assign a mailbox quota to an e-mail account. you can specify how much of your available disk space you want to allow this one e-mail account to use in the (3) "Mailbox quota (option:" field. Click the GENERATE PASSWORD button to have cPanel create a secure password for you.30 (C) 2012 Surpass Hosting .34 . If that happens the user will need to delete some mail to make more room for new mail that comes in. This means that this account could keep accumulating mail on the server until your web hosting account is completely out of disk space.

34 . If you click YES or if you select Configure Email Client from the More drop-down menu (see number (5) in the previous step).31 (C) 2012 Surpass Hosting .Configuring E-mail Clients Learn how to configure your e-mail accounts in the mail client of your choice. you will be asked if you want to configure an e-mail client to work with the new account. you will be taken to a screen similar to the cPanel Guide 11. Configuring Your Favorite E-mail Client After you create a new e-mail account.

you won't able able to see that old e-mail via webmail (more on webmail later). SSL stands for Secure Socket Layer and is the same sort of security you use on the web when you access an address using https:// (for example when checking out at Amazon. This method of communicating assumes that mail will come into the mail server and periodically you will connect with your favorite e-mail program (client) and download that mail to your local computer. You should not receive this message again for that account in that e-mail client. If for some reason the mail server isn't responding. Thunderbird.one above. There are two different types of communication protocols (you can think of them as languages if that is easier to understand) that the mail server that handles your e-mail can understand.com). If you decide to use SSL. POP3: This was one of the earliest "languages" for receiving mail that mail servers spoke. you may receive a warning the first time you try to access your mail in your e-mail client telling you that the certificate is not recognized. The mail only takes up space on the mail server until you download it in Outlook. you will still be able to view any mail you've downloaded locally. This is great if you mostly want to use a computer to check your mail. The problem is that the stored mail takes up space in your web hosting account so you may eventually need to remove some older mail permanently to make room for more files or mail. Apple Mail or some other e-mail program. This makes sure that no one other than you will be able to spy on your private e-mail while you are sending or receiving it. This screen will tell you the manual settings you need to know to configure most e-mail clients and also offer you simple one-click access to configure a number of popular e-mail clients.34 . SSL: Both languages can also "speak" in a more secure way that only your e-mail client and the server can understand (sort of like speaking in a secret code). All mail stays on the server and any e-mail clients you configure to use IMAP will all see exactly the same e-mail.32 (C) 2012 Surpass Hosting . IMAP: This is a newer receiving mail "language" that assumes that you will want to manage all of your e-mail on the mail server itself. let's discuss a few things you need to know about e-mail accounts and protocols. If so. SMTP: This stands for Simple Mail Transfer Protocol and it is the language all mail servers speak cPanel Guide 11. Before going any further. However. This is great if you constantly use different computers to access mail or if you use webmail a lot because you will always see all of your e-mail no matter what program you use. be sure to accept the certificate when prompted by your e-mail program. if you are out of town on business and need to look at an old e-mail you received a long time ago. where the mail will stay and then the mail on the server will be deleted. Mail stays on the server until you specifically delete the mail either via your e-mail client or via webmail.

Exactly how you do this varies from program to program. Ports: You can think of ports like different television channels. let's go back to discussing how to set up your e-mail client so that it can send and receive mail for your new e-mail account. like Thunderbird. Thunderbird or Apple Mail to check your mail if you don't want to." The only other thing you will need to know that isn't listed there is the e-mail account password. Just click on the appropriate (1) link on the screen pictured above. For security. Eudora. it should just check mail without prompting you for anything else. We'll discuss these more later. The mail server uses certain ports to communicate back and forth with your e-mail client. SMTP communications can also be unsecured or secured via SSL. if you chose to save the e-mail account password in your client.SMTP: This stands for Simple Mail Transfer Protocol and it is the language all mail servers speak when you want to send mail through them. etc. If you use Outlook. you will need to set up your new e-mail account manually. It is a good idea to use secure (SSL) SMTP connections.com (this is the mail server name used to check for mail cPanel Guide 11. These allow you to check and respond to your e-mail using any web browser. the password is not displayed on the screen above.com OR mailusername+yourdomain. From then on. If you use some other program. Outlook Express or Windows Live Mail as your e-mail client on a Windows PC or if you use Apple's Mail program on Mac OS X. Now that we have some of the confusing terminology out of the way. cPanel can help you set up your e-mail client to check your new e-mail account. Incoming Mail Server: mail. Your e-mail client already knows the standard ports that the mail server will use to communicate.33 (C) 2012 Surpass Hosting . If you have problems checking your mail using SSL then you can try the regular (unsecured) link. You can only communicate on a port if it is open on both ends (your computer and our server).34 . Pine. but all the information you need will be displayed on the screen above (at the bottom of the screen) under (2) "Manual Settings.com (either one will work) replace mailusername with the e-mail account username you created earlier. Your account's manual e-mail account settings: E-mail Account Username: mailusername@yourdomain..yourdomain. cPanel includes several webmail programs. NOTE: Normally you should select the secure (SSL) link from the screen above. Doing so should launch your e-mail client and set it up to work with your new e-mail address. but in some cases you may want or need to specify a different port. Webmail: You don't have to use Outlook. You will still probably be prompted (at least one time) for the password for this new e-mail account.

yourdomain.com (this is the server name you use to send mail from your new e-mail account. but if you have problems sending mail. 143 or 465 (your e-mail client should automatically set this for you and you shouldn't need to change it) Outgoing (SMTP) Mail Server: mail.com (this is the mail server name used to check for mail in your account .34 (C) 2012 Surpass Hosting .34 . switch this to port 26) cPanel Guide 11.Use this for both secure (SSL) and non-secure (non-SSL) connections.Incoming Mail Server: mail. .use this for both secure (SSL) and non-secure (non-SSL) connections) Incoming Mail Port: either 110.yourdomain.) Outgoing (SMTP) Mail Port: either 25 or 26 (your e-mail client with try to use port 25.

Modify Existing E-mail Accounts Learn how to make changes to e-mail accounts. In this section you can see some important information about the e-mail accounts you've created and you can manage each account from here. you can manage them in the Email Accounts section below the grey box. cPanel Guide 11.35 (C) 2012 Surpass Hosting .34 . Modifying Existing E-mail Accounts Once you've added at least one e-mail account.

The Usage column shows you how much disk space of your hosting account is being used by mail stored in this account. https://yourdomain. Only a full or home directory backup (discussed later) will be able to restore an e-mail account you've deleted and recover mail (up until the time of the backup itself). completely remove this e-mail account and any mail that might be stored in the account. Typically this is error messages or other issues from scripts running in your web hosting account.36 (C) 2012 Surpass Hosting . The default account username and password is always the same as cPanel Guide 11. Any mail you may have downloaded into your e-mail client via POP3 will still be there. Click the appropriate button to remove the account or cancel this action. you will see the e-mail addresses of the accounts you've created. but any mail stored on the server (new mail or any IMAP mail) will be destroyed. etc. just as if you had accessed webmail directly via https://yourdomain. Underneath the list of current e-mail accounts. You can also remove the quota and thus let the account store as much mail as you have available disk space in your hosting account. etc. the mail in that account will be gone for good. The Quota column shows you the maximum amount of disk space the e-mail account is allowed to use. you can change the password using this feature. While you can recreate an e-mail account later.34 .). You will be asked to confirm if you want to delete the account. Configure Mail Client: This feature will display the screen you saw in the previous step. This is a special system e-mail account that you cannot get rid of and that automatically receives unrouted e-mail sent to your domain. The next column provides you a quick link to access webmail for that particular e-mail account. filters. Delete will do just that.In the Account column. you will find the Default Email Account. The final column. Here you can set up your e-mail client to access this e-mail account. Simply select an item from the drop-down list and click the GO button. We will discuss webmail more a bit later. called Functions lets you manage that e-mail account.com:2096/. You can access all of the available webmail clients from this screen as well as common mail features related to the account you are logged in as (account password.com/webmail. Change Password: If for some reason you cannot remember the password you used for a particular e-mail account or if you are afraid someone else might have it. NOTE: Once you delete an account the account and all of the mail stored in that account on the server will be deleted. Access Webmail: Click this and you will be asked for that e-mail account's mail password and then you will be taken to cPanel webmail interface. Change Quota: This allows you to change the maximum amount of disk space in your hosting account that a particular e-mail account can use.

meaning that the e-mail address for this account is "yourcpanelusername@serverhostname. You cannot assign a quota to this special e-mail account. Here you can access webmail for this default account and see how much disk space is used by this account. we suggest setting up an e-mail forwarder pointing "yourcpanelusername@yourdomain. NOTE: Although you could use your default e-mail account as a real e-mail account.com. This default e-mail account is actually set up on the system level." If you need to use the system account as a real e-mail account.37 (C) 2012 Surpass Hosting .com" and not "yourcpanelusername@yourdomain. How to do that will be discussed in the Forwarders section. The default account username and password is always the same as your cPanel account login information. we do not recommend you do so.your web hosting account.com" to this cPanel system mail account. cPanel Guide 11.34 .

* All mail (sent and received) is stored on the server. For those times. Disadvantages: * You need to have Internet access and a web browser to work with your mail. * No configuration is needed. * Changes you make in your account will also be reflected in any e-mail client set up to check mail via the IMAP protocol. there are times when another method of checking and responding to mail will come in handy. although using an e-mail client like Outlook Express.38 (C) 2012 Surpass Hosting . Just log in and your mail is there. cPanel Guide 11. The cPanel Webmail Interface As mentioned earlier. cPanel provides a full-featured interface to check your e-mail using just a web browser (webmail). Using webmail has certain advantages and disadvantages: Advantages: * Check and respond to your e-mail from nearly any web browser. so you may run out of room to store mail eventually.Working with Webmail Learn how to access your e-mail in any web browser. Thunderbird or Mail is preferable for managing your mail.34 .

SquirrelMail and Roundcube all have different strengths and weaknesses. Regardless of which address you go to. you need to type one of the following into your web browser: https://yourdomain. Below that are three different webmail programs (2) that you can use to manage your mail. You might want to try them all until you find one you prefer. This is OK since our servers use self-signed certificates. At the top (1) it will show you what e-mail account you are logged in as right now. You can accept the certificate.com:2096/ http://yourdomain. which may be ideal for businesses.34 . It may take you some time to learn how to use all of its features. The three different webmail programs Horde. Cons: * The most complex webmail program. you will see a screen similar to the one shown above. Your webmail username is your full e-mail address (user@yourdomain. The password is whatever password you set up for that e-mail account.com/webmail http://yourdomain. Your mail session will be secure.com:2095/ You should use the secure (https://) addresses instead of the insecure ones if possible. * Some tasks may not be as easy to accomplish in a webmail program as they are in a desktop e-mail client.39 (C) 2012 Surpass Hosting .com/webmail https://yourdomain. * The program offers a single place to manage not only e-mail but also tasks and your calendar if you wish.com). cPanel Guide 11. Once you log in. Horde: Pros: * This webmail client offers the most functionality of any of the available choices. there are several options and features you can configure for this e-mail account (3). You may get a warning about the SSL certificate used if you connect via SSL. Finally. * This client is a full "groupware" solution.* Webmail programs don't necessarily offer the same robust features for working with e-mail as desktop e-mail clients do. you will then be prompted to enter your webmail username and password. This will help stop a malicious person from eavesdropping on your e-mail while your working with it in your web browser. To access cPanel's webmail features. at the bottom.

* This program won't work in all web browsers (requires javascript). Cons: * Other than checking and responding to e-mail. Ideally Suited For: People who are used to working in Microsoft Outlook or other groupware. For most people. * Easy to learn.0" style webmail program. Squirrelmail: Pros: * Quick loading. modern looking interface. Roundcube Mail: Pros: * Program acts just like a desktop e-mail client (you can drag and drop messages to move them or delete them.40 (C) 2012 Surpass Hosting . etc. * You don't have to refresh interface to check for new mail. * Works in a very wide variety of web browsers (even with Javascript off). this program doesn't offer many features. Squirrelmail is probably the best overall choice. * Clean. cPanel Guide 11. Ideally Suited For: Apple Mail users or anyone who wants a "Web 2. Cons: * Program looks a bit "plain" (no flashy graphics or visual effects). * Doesn't always work well in all web browsers (though any modern browser should be OK).features. but all three of them are fine programs. * You can change how the program looks if you don't like the default theme. The interface doesn't have a ton of graphics or special code that slows down the program. Ideally Suited For: Anyone who just wants to work with their mail quickly and doesn't care about how the program looks.34 .) * Very low learning curve if you are used to a desktop e-mail client. * Contact and other groupware data is stored in a MySQL database that you cannot directly back up. * Doesn't offer quite as many features as Horde. though you can export your contacts from within Horde itself and we recommend doing so periodically.

click "[Enable Autoload]" under the program you wish to use (not shown in the screenshot above). cPanel Guide 11. All of the features listed below the three webmail programs are features that have been or will be discussed in-depth elsewhere in this chapter (they are just links to standard cPanel functionality for that one e-mail account).34 . To do so.If you find that you use one of the above programs a lot you can choose to have that program start automatically when you enter the cPanel webmail interface.41 (C) 2012 Surpass Hosting .

Combatting Spam using SpamAssassin cPanel offers a server-side anti-spam (unsolicited e-mail) tool called SpamAssassin.Combatting Spam Learn how to use SpamAssassin to fight spam. cPanel Guide 11.34 . SpamAssassin is a widely used open source spam rating tool.42 (C) 2012 Surpass Hosting .

Initially. However. In order to use SpamAssassin effectively. The SpamAssassin score can be any number (there are no limits) either positive or negative. you may want to have the potential spam filtered into a separate. cPanel Guide 11. SpamAssassin uses a large number of special rules and its own anti-spam database to try and figure out how likely each piece of mail is to be spam. SpamAssassin then adds special headers to every mail message giving each one a score where lower numbers are less likely to be spam and higher numbers are more likely spam. when you turn on SpamAssassin. it will start scoring every message received and it will automatically delete any mail received that achieves a score of 20 or more. If that is something you are interested in. When SpamAssassin is turned on. SpamAssassin will not be enabled.43 (C) 2012 Surpass Hosting . special spam mailbox to make it easier to go through. SpamAssassin automatically looks at every piece of mail being delivered to your e-mail accounts even before they reach your mailbox. you may want to watch the mail that gets labeled as spam so you know if the current settings are effective. SpamAssassin can help remove most of the spam from your account before it reaches your inbox. any message with a SpamAssassin score over 5 will have the message's subject prefixed with "***SPAM***" because the message will be considered likely spam. Various actions can be taken based on the score assigned to the message by SpamAssassin. Enabling this feature will create a separate mail folder on the server called "spam" and all messages that SpamAssassin rates as likely spam (a score of 5 or higher by default) will automatically be rerouted to the new spam folder on the server.http://spamassassin.org/ When properly configured. When enabled.apache. this button will change to DISABLE SPAMASSASSIN. Rather than have the messages that SpamAssassin thinks are spam mixed in with your "good" mail.34 . By default with SpamAssassin on. regardless of your other settings (since that is a server-wide setting). the message will still be delivered to your mailbox (where the changed subject line should make it easy for you to filter out the message locally). so you should enable it by clicking on the (1) ENABLE SPAMASSASSIN button. it is important to understand a bit about how it works. from changing the subject (denoting the message may be spam) to rerouting the message to another location or deleting it immediately. Once it is enabled. click on the (2) ENABLE SPAM BOX button. By default.

If you are done testing settings. If you've gone through the spam box and it contains nothing but messages you do not want.34 . This does not turn off the spam box feature. so you will never see them in your inbox. you can click the (3) CLEAR SPAM BOX button and all messages in the spam mail folder on the server will be deleted. cPanel Guide 11. then you probably need to increase the SpamAssassin score where messages are considered spam. you can use webmail. then you may want to lower the score at which SpamAssassin considers a message spam. This will create a special mail filter on the server that will delete any messages marked by SpamAssassin with a score at or higher than the number you chose. See the next step for the details available to you on that screen. if you find that SpamAssassin is not catching enough spam. you can turn off spam box by clicking the (2) DISABLE SPAM BOX button. you can move them to your regular inbox and then make changes to your SpamAssassin settings as needed to try to make sure that it only catches actual spam. Alternately. If you don't see the spam folder. If you find that SpamAssassin is catching too many good e-mails as spam. To delete spam automatically as it comes in. use the mail folders features in your webmail client of choice to subscribe to the spam folder so you can view it. Click on the "spam" folder in your preferred webmail client and you will see only the messages that SpamAssassin has labeled as spam. but it's not an ideal long-term solution.To check the spam box. If there are false positives. You can choose to have messages deleted automatically if SpamAssassin thinks they are spam. You can make changes to your account's SpamAssassin settings by clicking on the (6) CONFIGURE SPAMASSASSIN button. select a cutoff score (4) and then click AUTO-DELETE SPAM. Newly identified spam will continue to be delivered to the spam box. If you decide you don't want to auto delete spam press the (5) DISABLE AUTO-DELETE SPAM button and the special mail filter will be removed. We will discuss how that is done shortly. This will allow you to review the mail to see if there are any false positives.44 (C) 2012 Surpass Hosting . The spam box feature is a good idea while you are trying to fine-tune the SpamAssassin settings. Messages are deleted as they get processed for delivery.

We recommend you only change the settings on this page if you've taken the time to learn more about SpamAssassin and fully understand how these settings cPanel Guide 11.SpamAssassin Advanced Configuration The SpamAssassin Configuration screen allows you to set advanced SpamAssassin options that can help improve spam recognition.34 .45 (C) 2012 Surpass Hosting .

enter the first 5. For example. if you find that SpamAssassin is labeling too many good messages as spam. enter it on one of these blacklist lines exactly as it appears in the spam you receive.46 (C) 2012 Surpass Hosting . To do that.com would block any mail with a From line containing any AOL e-mail account. you may want to increase this number.org/tests_3_3_x. Conversely. You will see the items you've added with extra empty lines so you can add more. NOTE: The settings on this screen apply to all domains and e-mail accounts managed by this cPanel account. If you have more than 5 addresses to blacklist. The most important item on this page is the (1) required_score item. If you want to label all mail from certain domains as spam. Be careful not to set this too low or SpamAssassin may start labeling good messages as spam. You can see a list of the tests that SpamAssassin uses here: http://spamassassin. this number is set to 5 which is probably a good number for many people. regardless of other settings. entering *@aol.34 . If you find that you are constantly getting spam from certain e-mail accounts or domains. This changes the score that makes SpamAssassin label a message as likely spam. if you find that SpamAssassin is not catching enough spam. However. Before changing this number. then click (5) Save and go back into the Configure SpamAssassin screen.will affect SpamAssassin. SpamAssassin uses a large number of special tests to try and determine if a piece of mail is spam or not. Some tests are assigned negative numbers (meaning that a piece of mail is less like to be spam if it matches the conditions in that test) or positive numbers (meaning that a piece of mail is more likely to be spam if it matches the conditions in that test). By default. Using the test name from the list above. it is best if you watch what SpamAssassin labels as spam and not spam (perhaps using the Spam Box feature mentioned previously). you can blacklist them so that SpamAssassin always marks them as spam. Don't forget to use wild card (* or ?) characters as needed. you may want to make this a lower number. enter up to five different domains or e-mail accounts into the (2) blacklist_from section. you can reset the score by changing it on the score line like this: score TEST_NAME score1 score2 score3 score4 cPanel Guide 11.apache. SpamAssassin has a default "spam" score for each test. Keep adding 5 at a time and saving until you've entered everything you need to. To enter just a single e-mail address. use an asterisk.html It is possible to change the default weighting for the tests that SpamAssassin uses if you don't think they are working optimally.

You should enter only one e-mail address or domain per whitelist line (4). change the first five. Only enter one test score per line. Third number: This is the weight used when Bayesian tests are enabled but network tests are disabled.score TEST_NAME score1 score2 score3 score4 The TEST_NAME is the SpamAssassin test name from the tests list above. The whitelist follows the same rules as the blacklist does. NOTE Score values can be any positive or negative number. If you have more than 5 address to add.1 This would change the EMAIL_ROT13 test (which looks for ROT13 encrypted e-mail addresses) from the default weight of 1 to a new weight of 5. Fourth number: This is the weight used when both Bayesian and network tests are disabled.47 (C) 2012 Surpass Hosting . You can use * and ? as wildcard characters to apply the whitelist settings to multiple addresses.1. If you use more than one. save changes (5) and then return to this screen to enter another 5 until you are done. enter the first 5 and then save changes (5) and return to this screen to enter additional whitelisted addresses. Positive scores make mail matching that test more likely to be spam and negative numbers make the message less likely to be spam. Second number: This is the weight used when Bayesian tests are disabled but network tests are enabled. If you need to change more than 5 test weights. followed by up to 4 different numbers.34 . Example: score EMAIL_ROT13 5. then the scores you specify affect the following: First number: This is the weight used when both Bayesian tests and network tests are enabled (which they are on our servers). if you have some e-mail addresses that you want to make sure never get labeled as spam. you can add them to the SpamAssassin whitelist. If you specify only one number. Finally. that becomes the new weight for that test in all cases. cPanel Guide 11.

For example.com" that sends all received e-mail to jeff@yourdomain.com.34 . No one has to set up or log into cPanel Guide 11. If someone sends mail to sales@yourdomain.Mail Forwarders Learn how to work with e-mail forwarders.48 (C) 2012 Surpass Hosting . you could set up an e-mail forwarder called "sales@yourdomain.com and you@aol. Managing Mail Forwarding To access e-mail forwarding features.com that same e-mail will be sent immediately to both jeff@yourdomain. An e-mail forwarder does just that.com. An e-mail forwarder (sometimes called an e-mail alias) is an e-mail address that isn't a full e-mail account with its own mail storage.com and to you@aol. click on Forwarders on the cPanel home screen. it forwards e-mail to another e-mail account (or several e-mail accounts) that you specify.

mail will be received and stored in that e-mail account AND a duplicate copy will be forwarded to the e-mail accounts you specify.com forwarding mail to your yourdomain.the sales@yourdomain. (These options are in the Functions column of the address list). NOTE: It is possible to set up an address as a real e-mail account and as a forwarder. you can use the Search feature to locate the forwarder or forwarders your are looking for.com isn't set up as a real e-mail address or isn't forwarded elsewhere the e-mail will be handled as your default or catch all address is. In this case. If you need to make changes to the forwarding settings for an address then you need to delete the existing forwarder and create a new one with the modified settings you require. The forwarders that match what you entered will be displayed. Select the domain you want to forward and the domain you want all mail forwarded to and save changes.com domain.49 (C) 2012 Surpass Hosting . you can tell cPanel to run a test trace on the new forwarder (to help you find forwarding problems) or you can delete a forwarder.com mail account. cPanel Guide 11.34 . Simply type in all or part of the forwarder(s) you are looking for and click the (2) GO button. Just create an e-mail address with the same name using the Email Accounts feature in cPanel and then set up the same address to forward mail to whatever other addresses you want to forward mail to in the Forwarders feature in cPanel. click (1) ADD FORWARDER from the screen above. then mail to user@yourdomain2. you can have all mail that is sent to one domain automatically forwarded to another domain. because it is not a real e-mail account. For example. If user@yourdomain. click (3) ADD DOMAIN FORWARDER. if you have yourdomain2.com.com will be sent to user@yourdomain. You cannot actually edit an existing forwarder. Note that once you have one set up. See the step below to learn how to configure a new forwarder. it just forwards mail to other addresses. To add a forwarding e-mail address. If you have a lot of forwarders set up. From then on all mail for the forwarded domain will be sent to the domain you want mail forwarded to. If you own more than one domain and the domain is parked or added on to your cPanel account. To set this up.

Type in the name of the account you want to create as a forwarder in the (1) Address section.34 . You can also set mail to automatically fail and get bounced back to the sender with an error you specify (3). cPanel Guide 11.Creating a Mail Forwarder Now you are ready to create a forwarder. and make sure you have the correct domain name selected (you can set up forwarders for any domain name parked or added on to your cPanel account). You can then specify an account you want mail to get forwarded to when it is sent to this address (2). but you have several decisions to make about how you want the mail handled.50 (C) 2012 Surpass Hosting .

Finally. If you want to have the same forwarder send mail to multiple places. so make sure the permissions on the script you are sending mail to is set to 755. just choose to add a new forwarder again and enter the same starting (forwarding) address with a different destination address. If you are sending mail to a script. you can forward the message to a system account. The script needs to allow other users to execute it (at least). pay attention to the notes in this section. Also. just the path inside your home directory (for example public_html/script/mailparser. Keep doing this until you have all the places you want the one forwarder to forward mail to set up. you can just specify the username without a domain name. When you are done setting up your preferred option. If that is missing.Under the advanced options. see the details about Mailman later in this guide. To send mail directly to a script. cPanel will try to guess the path you are typing in a box that appears just below where you are typing. Since it is a system-level account. By default. If you have a modern browser and javascript support. Select one of those options to have it automatically filled in. Remember when we said earlier that your main cPanel mail address that is set up automatically is actually a system level account? This option will allow you to send the mail to a system account you specify. select (5) Pipe to a Program.34 . click the (7) ADD FORWARDER button. cPanel will try to prompt you and then try to add the hashbang automatically. You can create a quick and dirty mailing list this way. Just keep in mind that if someone sends spam to that address all of the recipients will receive that same piece of spam.) This is not recommended because doing this violates RFC guidelines and it also doesn't allow cPanel to attempt to protect you from spammers attempting dictionary attacks (a spammer sends mail to random names at a domain trying to look for valid addresses). (The mail will be quietly accepted and then deleted instead of being forwarded. So if you really want to have an interactive mailing list. Another advanced option allows send the e-mail to a script stored in your account. you can choose to have mail sent to this address automatically deleted without any warning or notice to anyone (6). make sure that there is a hashbang at the top of the script. Some scripts have the ability to process incoming mail if it is sent directly to them (some helpdesk scripts for example). so selecting an option will deselect the others.51 (C) 2012 Surpass Hosting . cPanel Guide 11. NOTE: You can only select one of the options listed above. See the small house icon? That means that the system already assumes the script you are sending mail to is located somewhere in your home directory (for example /home/CPANELUSERNAME/) so you don't need to specify that. this field (4) is set up with your cPanel username already filled in.php).

The (2) Interval you set controls how often someone will receive your auto response message if cPanel Guide 11. but if your writing in another language and know the character set you need to use. even if you aren't around to personally answer them. The first thing you should do is select a character set. cPanel allows you to do this through the Autoresponders feature on the cPanel home screen.34 . For most people. utf-8 is the best choice.52 (C) 2012 Surpass Hosting . Setting up Auto Responders There may be times that you would like people to get a response when they send you an e-mail.E-mail Autoresponders Learn how Autoresponders work and how to create and manage them responsibly. select it from the (1) Character Set drop down menu.

You can use: %subject% This will be replaced with the subject line of the incoming e-mail that triggered the auto response. It is not possible to force the system to constantly send auto responses to every e-mail received. Next. That means that if someone sends mail to this address where you have the responder set up. The name you type in here does not have to be a real e-mail account you've already set up. You must set an interval.COM Team" or type your own name there. This could be anything you like.34 . This is to try to stop inadvertent mail bombing (sending hundreds or even thousands of auto responses to an innocent person because a spammer has spoofed their e-mail address). The (7) Body: field is where you type the response message you want to send. If you want to send just a plain text auto response.they continue to send you email. This name will be pulled from the From: line of the incoming message. no matter how many messages they send you. The (4) From: text field is what people receiving the auto response will see in the From line of their e-mail. they will only receive one auto response once in any give 8 hour period. This e-mail cPanel Guide 11. As an example. These variables will be automatically be replace with information from the incoming message that triggered the auto response. you won't ever see the e-mails that were sent to that address. The default is 8 hours. then mail to that address will only be handled by the autoresponder. %email% This will list the e-mail address of the person who sent you an e-mail. type in the username of the e-mail account you want to set this autoresponder up for into the (3) Email field. If there isn't already an e-mail account set up with this username.53 (C) 2012 Surpass Hosting . you can select it from the drop down list next to where you typed the e-mail username. leave this unchecked. Anything typed into the (5) Subject: field will be displayed as the subject of the auto response e-mail message. check the (6) HTML Message: check box. If you plan to paste HTML code into your message body. If you have more than one domain parked or added on to your cPanel account. %from% This will be replaced by the name of the person who sent you an e-mail." A subject is required for all auto response messages. For example: "Thanks for your inquiry" or "I'm on vacation. You can use some variables in the subject line or body of your message. you could enter "The YOURDOMAIN. This can be anything you like. NOTE: The auto responder screen does not have a WYSIWYG HTML editor built-in. so it will be up to you to create valid HTML code in some other program first and then paste the results in the Body: field.

Once you are sure you have everything the way you want it.34 . This e-mail address will be pulled from the From: line in the incoming message.%email% This will list the e-mail address of the person who sent you an e-mail. For this reason. click the (8) CREATE/MODIFY button to enable this auto responder.54 (C) 2012 Surpass Hosting . cPanel Guide 11. NOTE: The auto responder will automatically send your response to any e-mail that comes in to the auto responder's e-mail address that you specified. be careful when you set up an auto responder because you may find that you get reported as a spammer when your auto responder sends e-mail to a spoofed address in a spam message. so it will respond to spam just as readily as it will to a legitimate message. The auto responder cannot differentiate between types of incoming mail.

Setting your Default/Catch-All E-mail Address In cPanel it is possible to have any mail sent to one of your domains (to accounts that are not already set up) forwarded on to any e-mail address. To use this feature.55 (C) 2012 Surpass Hosting . To discard the mail with an error. We recommend that you set your default address to discard mail with an error to sender.Handling Unrouted E-mail Learn to control how unrouted mail gets handled. Choosing any other option may greatly increase the amount of spam you receive. select Default Address from the Mail section on the cPanel home screen. select the domain you want to set a default address action to from the (1) drop-down menu under the phrase "Send all unrouted email for:" click the (2) radio button next to "Discard with error cPanel Guide 11. sent to a script or ignored or bounced with an error message.34 .

The advanced options are: (4) Forward to your system account. You should rarely. but should you need to forward mail to a script or delete mail sent to non-existent e-mail addresses in your domain. if ever.to sender at SMTP time)" and then click the (7) CHANGE button. This is not recommended as our servers are configured to notice the typical bounce messages and to help you avoid spammer abuse. then type the e-mail address into the (11) text box next to "Forward to email address" and then clicking on the (7) CHANGE button. you can change the error message people see when they e-mail a non-existent address by typing in a new error message into the (8) text field next to the "Failure Message (seen by sender):" line and before you click the (7) CHANGE button. If you would rather that all mail sent to any address at one of your domains gets forwarded to a valid e-mail account.56 (C) 2012 Surpass Hosting . Optionally. cPanel Guide 11. need to use the advanced options. You can send your mail to the main e-mail account (this is the system level account we discussed earlier that is actually CPANELUSERNAME@SERVERHOSTNAME. you can click on (10) "Advanced Options >" and set up the appropriate item as you wish and then click the (7) CHANGE button.34 . (6) Discard: This will just delete unrouted mail without responding back to the sender. select the appropriate domain from the (1) drop-down list and make sure the (3) radio button next to "Forward to email address" is selected. cPanel shows your (9) current setting near the top of this screen. If you discard the mail without responding then it may encourage spammers to send you even more spam (as they continue to look for valid addresses). The script has to be able to parse incoming mail and be executable or you will receive errors every time this pipe is triggered. Don't forget to click the (7) CHANGE button once you set your preferred routing method. (5) Pipe to a program: This allows you to send all unrouted e-mail to a script for processing.COM).

To create a new list. cPanel uses a specially modified version of a program called Mailman http://list. Retype that same password into the (3) Password (Again) field. or you can use the (4) PASSWORD GENERATOR to create a random. If you want a program that can handle such tasks. NOTE: Mailman is not designed for use for newsletters or other one-to-many items where you want to send something to many people but not permit them to "talk back" to you and everyone else on the list. If so. which is also available for installation by Fantastico or Softaculous.org/ Mailman makes it easier to manage e-mail discussion lists.34 . and then click the (5) ADD MAILING LIST button to complete cPanel Guide 11. you can use cPanel's Mailing Lists feature to create and manage such discussions. look into PHPList http://phplist.Setting up Mailing Lists Learn how to set up and manage Mailman mailing lists. secure password instead.57 (C) 2012 Surpass Hosting . Setting up a Mailing List You may occasionally need to facilitate discussions between groups of people on a particular topic. either moderated or unmoderated.com/ . type the public name of the list into the (1) text field next to the words "List Name" then type in the administrator's password into the (2) Password field or use the GENERATE PASSWORD button to create a secure password automatically.

but the mailing list data is stored outside of your home directory. Any active mailing lists will appear in the Current Lists section. Also. (7) change the main administrator mailing list password.the process.34 . NOTE: Mailman is too complex a program to discuss the administration of mailing lists in this document. There you can see the list name as well as links to (6) delete the list. NOTE: If you have more than one domain added to your cPanel account. you can visit Mailman's website for assistance. so the only way to back that data up is to use a full backup. If you need help.58 (C) 2012 Surpass Hosting . there will be a drop-down list under the (1) List Name field that will allow you to select the domain on which to set the mailing list up. Mailman mailing lists do count against your disk space use limits. cPanel Guide 11. or (8) modify the mailing list settings (which opens a new window and takes you to the Mailman management interface.

However. click on User Level Filtering on cPanel Guide 11. Individual E-mail Account Server-Side Filters Most desktop e-mail clients have the ability to apply filters to incoming mail to help you manage your mail. it will work best if you use IMAP or webmail to access your mail. what happens to mail that comes in when you are checking your mail via a webmail client? Those desktop e-mail client filters won't be applied! So what can you do? Thankfully. cPanel offers you the ability to apply server-side filters to incoming mail on a per-e-mail account basis. Filters you set up in cPanel get automatically applied at the time the mail gets delivered to your mailbox on the server itself. if you manage your mail in your desktop e-mail client. either by moving it into a special folder.34 . deleting it or performing some other basic action on the mail before you even read it. To set up a server-side filter on on one particular e-mail account. Although this feature will work no matter what protocol you use to access your e-mail.Server-side E-mail Filtering Learn how to add/edit server-side e-mail filters to have e-mail sorted or deleted according to your wishes.59 (C) 2012 Surpass Hosting .

) and then enter the (4) value to look for or act on. Name your new filter by typing in a name into the text box next to (1) "Filter Name:" The name will allow you to quickly pick out the filter you want to work with if you need to edit it later. one at a time until you are certain that this filter will only get applied to the messages you want it to apply to. you set up the various conditions you want the server to look for before it applies certain actions to incoming mail. you can test your new filter by setting up a test message in the filter test box displayed and then click Test Filter. You can (7) delete the message that matches this rule. Select the appropriate action (like deleting (discarding) a message or moving it to another mail folder on the server.60 (C) 2012 Surpass Hosting . To:. When you are happy. and Subject: lines. Next. Also. cPanel will warn you and make you choose a new one. in order to trigger this filter the message being evaluated has to match this rule AND any others you specify. fail (bounce) the message or send the message to a new mail folder.buttons next to the action. begins/ends with. Rules can look at nearly all key areas of an incoming message including the From:. You can add or remove additional actions by using the (8) + or . you can even select the SpamAssassin spam headers to act on (in fact. The exact options you will have depend on the field you chose to act on in the appropriate (2) drop-down box. does not equal. Multiple rules are parsed in the order listed on this screen. click the (9) ACTIVATE button to create the filter.34 . called rules. Once you have the rules set up in the order you want them. If you have SpamAssassin enabled. If you try to enter an invalid filter name. this is how the SpamAssassin auto delete spam feature works). you may be able to select a (3) boolean operator (equals. Once back on the main filters screen. Note that this will not actually send a cPanel Guide 11. You start by selecting the field that want to have the rule look at and select it from the (2) drop-down box. You will be presented with the screen above. You can then add more rules by clicking the (5) + button or remove this rule by clicking on the . send the message to another account. You then specify what you want done with any message that matches the Rules. Filters will apply almost immediately. Note that the name must be unique for every filter you create. You can change the order that rules get parsed by using the (6) up or down arrow next to the rule to move. If you choose OR then the filter will be triggered if this rule OR any others you have set up have been matched. if you have multiple rules you will be able to specify AND or OR. you then can specify one or more actions to take if the conditions specified in the rule(s) are met.button. You set up these conditions. stop processing any other filters on this message. If you select AND. You can have multiple actions applied to any message by clicking the + next to the shaded Actions box.the cPanel home screen and then click Manage Filters next to the e-mail account you want to set up filters for and click Create New Filter or click on an existing filter to manage it. Once you've picked a field to act on. etc.

Whole Account Server-Side Filters You can also apply a set of filters to all mail coming into your cPanel account (including all addon domains) by clicking Account Level Filtering on the cPanel home screen.34 .61 (C) 2012 Surpass Hosting . Adding or removing account level filters works very similarly to the e-mail account level filters mentioned in the previous step. To create a filter that will be applied to any e-mail coming into your account. If you want to learn more about setting up rules and actions. Note that this will not actually send a message. please read Working with Mail: Individual E-mail Account Server-Side Filters. regardless of which cPanel Guide 11. it just runs a test on your filters and shows you the result so you can see if the filter(s) you've set up work as you desire.the filter test box displayed and then click Test Filter.

cPanel Guide 11.specific e-mail account it is going to. You can (2) Edit or Delete an existing rule (if there are any) and test your existing filters by entering a test message in the (3) Filter Test box and then clicking (4) Test Filter. NOTE: The Test Filter feature will not actually send a message. These options will not appear unless you've set up at least one filter already. This will take you to a screen that looks like the screenshot in the previous step. Follow the same steps to set up a filter as discussed earlier. shown above. click on the (1) CREATE A NEW FILTER button. it just runs a test on your filters and shows you the result so you can see if the filter(s) you've set up work as you desire.34 . Follow the rule/action creation steps and you will be brought back to the main screen.62 (C) 2012 Surpass Hosting .

Testing E-mail Routing Learn how to view a report to see if e-mail is getting routed properly.63 (C) 2012 Surpass Hosting . cPanel Guide 11.34 .32. This feature allows you to check e-mail deliveries to an e-mail account you choose. the newly expanded and renamed Email Trace feature in cPanel replaces the old Email Delivery Route feature. This can help you track down problems with sending or receiving mail. Working with Mail: Testing Mail Routing In cPanel 11.

Also. Below the delivery report is the (5) Email Address Trace. However. You will see a note at the bottom of the delivery report telling you the maximum amount of time that cPanel is currently storing your mail report data for. the amount of mail data that cPanel keeps track of will vary. enter a full e-mail address into the (1) text field near the top of the screen and then click the (2) RUN REPORT button.34 . "admin@domain.To start a trace. NOTE: You can run a trace on ANY e-mail address. cPanel keeps track of inbound and outbound mail to or from addresses in domains that your cPanel account manages. but there is also a forwarder set up that sends a copy of the mail to another real e-mail address on the server. In the example above. This is what cPanel used to show you in the old Email Delivery Route feature. NOTE: You can only view messages in this report if cPanel manages your email and the account is one of the ones controlled from your cPanel account. At the far right in each report row. It is a semi-graphical map showing the delivery process that your server goes through to deliver a message to the e-mail address you entered earlier. If the address you ran the trace on has recently had mail sent to or from your cPanel account. you can choose to display only those items that are most important to you. then a list of those messages along with delivery details will be displayed.com" is set up as a real e-mail account in cPanel.com. "test@domain. many more than will comfortably fit in the standard width that cPanel allows. There are a lot of details cPanel can display in the report. then cPanel will not be able to show you anything in the report because mail is not managed on your server. You can also tell cPanel to remember your choices for future e-mail traces.64 (C) 2012 Surpass Hosting . Once you've started a search. Check items you want to appear in the list and uncheck those you don't want to see and the delivery report will automatically adjust to include those details. even if it is not managed by your cPanel account. the first is the (3) Delivery Report. Depending on the information being retrieved. the amount of data you will get from the trace will be limited. it may take a few moments for data to appear." The map shows us that first the server checks to see if there are any cPanel Guide 11.32. you can view a pop up detail list that provides more information (some that may not already appear in the list). so be patient. two new sections will appear. The report will show you a green circle with a checkmark if the delivery went well (as far as cPanel can tell) or an inverted triangle with an exclamation point if there might have been a problem (or if the message was spam). At the bottom of the page os the legend of symbols used in the map. so you may only have a few days of mail visible in the report or you may have many weeks of data available. You do that by clicking the (4) list preferences icon that appear at the top-right of the delivery report. Thankfully. This is new in cPanel 11. If you use a third-party for your e-mail (like Google). You can also increase or decrease the number of displayed rows per page or flip through pages.

com. that triggers sending a copy of the message to the local mailbox of "admin@domain.65 (C) 2012 Surpass Hosting .com. Since there is.34 ." There are no errors in the mail route. cPanel Guide 11." The map shows us that first the server checks to see if there are any forwarders (valiases) set up."admin@domain.com" and then the original message is delivered to the local mailbox of "test@domain.

To get started.csv)).34 . click on Import Addresses/Forwarders on the cPanel home screen. If you've never used this feature before.Importing E-mail Accounts and Settings Learn how to prepare and import e-mail accounts. Clicking on it will bring up a new on-page window (2) Setup CSV/XLS for Importing. However. This will explain how to save the e-mail or cPanel Guide 11. including the free Open Office or its offshoot. many programs can save data in . then cPanel has its own Backup and restore features. It uses spreadsheet files (either a standard Excel spreadsheet file (. Even if you don't own Microsoft Office. which will be discussed later. if you need to import e-mail accounts or forwarders from non-cPanel hosting accounts and cPanel offers a way to do this.xls or .66 (C) 2012 Surpass Hosting .csv format. forwarders and settings from other e-mail providers. you absolutely should click on the large link asking you if you (1) Need help setting up a CSV or Excel file for importing.xls) or a comma separated values file (. Libre Office. Working with Mail: Importing Email Accounts or Forwarders If you want to import e-mail accounts or forwarders from a cPanel account.

Keep them in separate files. click the (7) Browse. The only data you must have is one column with the source e-mail address and then another column with the destination address. select that header row and then click Next to continue. Below that. Do not mix e-mail and forwarders in the same file. The top of the window shows you how to save a spreadsheet containing the data needed to import e-mail accounts.xls or . The only data you really must have is a list of email addresses. Then in Step 2. On the next screen. select either (6) E-mail Accounts or Forwarders from Step 1 depending on what you want to import first.csv files showing you how to set up the forwarders file. Once you have the files you need to import. cPanel Guide 11. If everything looks OK.csv file. is an example of how you set up your spreadsheet to set up forwarders. but you can also list the domain name.csv files to see how they need to be set up. You can even download (3) sample . password and disk quota size (in MB).67 (C) 2012 Surpass Hosting . though. You can download (4) an example . a row that contains the titles for each column).. If the data doesn't look right. then click the FINISH button to complete the import process. Click the (5) CLOSE button at the bottom or top of this popup window to close it..34 . check the format of your .. cPanel will show you the top of your file.e. cPanel will then parse the data in the file and then show you what it is going to try to import.xls or . Finally click the (8) Next button to start the import process. button to select the file you want to import.forwarder information in a file that cPanel will be able to read and import.xls or . If your file contains a header row (i.

Combat E-mail Spoofing Learn how to fight e-mail spoofing (and some spammers) by using SPF or DomainKeys records.68 (C) 2012 Surpass Hosting . cPanel Guide 11.34 .

69 (C) 2012 Surpass Hosting . due to the way e-mail service works on the Internet right now.SPF and DomainKeys Records As you may be aware.34 . Various methods of reducing this issue without completely changing the way e-mail service works have been cPanel Guide 11. it is very easy for spammers or scammers to spoof the sender of an e-mail message.

then you will not be able to use cPanel to enable DKIM support. DomainKeys records are compatible with the newer DKIM specification. so if you want to enable them then you should select Email Authentication from the cPanel home screen. Contact the company that manages your mail service or domain to learn how to enable DKIM. cPanel offered DomainKeys. just click the (2) ENABLE/DISABLE button. However. Receiving mail servers can check your SPF record and make sure that the mail they are receiving are from a permitted sender. If you try to enable this and your domain doesn't resolve to our server or if your MX (mail) record(s) don't point to our server. That record tells others what mail servers are permitted to send mail from your domains. It is either on or off. NOTE: You cannot enable DKIM unless our server is the primary mail server for your domain(s). SPF works by adding a special TXT record to the DNS zone for your domain(s). just click the (1) ENABLE/DISABLE button. So long as cPanel detects that it manages your domains and acts as the primary mail server. The recipient can retrieve the public key from your domain's DNS records and use it to help ensure the message they are looking at really came from your domain. To enable or disable DKIM support in cPanel. If you have more complex needs or if you want to make the SPF record stronger. SPF is somewhat more commonly implemented. but is more complex for mail service managers to implement. DKIM is the "successor" to DomainKeys. you can edit it by using the Advanced Settings. it will be displayed here as well. If you have an active SPF record. the end user. NOTE: cPanel 11.70 (C) 2012 Surpass Hosting . Right now. DKIM isn't used as often as SPF. They are disabled by default. For either technology to work. cPanel supports two different anti-spoofing technologies. DKIM works by creating a public and private key that is used to digitally sign parts of your outgoing message. The two supported anti-spoofing technologies are DomainKeys Identified Mail (DKIM) and Sender Policy Framework (SPF). it will let you know.discussed.32 has added support for DKIM. DKIM is the easiest for you. cPanel Guide 11. it has to be supported both by the sending domain and by the receiving mail server.32. There are no additional settings to worry about with DKIM. it is still a good idea to enable since it will make it easier for your mail to get through to recipients. probably because it is somewhat easier for mail server administrators to set up.34 . to enable in cPanel. To enable or disable SPF. however. Prior 11. Both techniques use slightly different methods to accomplish basically the same thing: Assure that the mail really did come from the listed user's domain. then it will be enabled/disabled. DKIM combines the old DomainKeys specification with the Identified Internet Mail specification. This will set up/remove a basic SPF record that should work for most people. If cPanel notices an issue.

The (3) "Additional Hosts that send mail for your domains (A):" section allows you to add the IP addresses of other mail servers that you want to allow to send mail from your domain. you should check this box. enter those hosts here. If those domains have their own MX records. check (8) "Overwrite Existing Entries:" if you want to replace all existing SPF records with the sections you've just made. this field will remain empty (our mail server is automatically allowed without your having to specify it here).71 (C) 2012 Surpass Hosting . If you just want to test your SPF record or you are not certain you've entered everything correctly. However. The (4) "Additional MX servers for your domains (MX):" section allows you to specify other mail servers (machines) that are permitted to send mail for your domain. if other mail servers that check SPF records detect mail coming from another host or IP address not in your SPF record. when you are done testing and sure you have the SPF record the way you want it. The (5) "Additional Ip blocks for your domains (IP4):" section allows you to enter IP addresses of other IP addresses that you want to allow to be able to directly send mail for your domain. With this box checked. The advanced SPF settings let you modify your default record so that you can fine tune it and provide a more definitive record that others can safely rely on. those records will also be included with this record automatically. Typically. the receiving mail server should reject the message. otherwise the existing entries won't be replaced. be sure to leave the (7) "All Entry (ALL):" item unchecked. The (6) "Include List (INCLUDE):" section allows you add other domains that also send mail for this domain. Enter each one separately by clicking the ADD button or select one from the list and click the DELETE button. but not through our server. You don't need to enter our server. it will be displayed here as well. Enter each one separately by clicking the ADD button or select one from the list and click the DELETE button. If you have other mail senders (perhaps a third-party mailing service) that regularly send mail that comes from your domain. Enter each IP address separately by clicking the ADD button or select one from the list and click the DELETE button.active SPF record. cPanel Guide 11. Finally. Our server will automatically be allowed. as this is automatically allowed. If this item is unchecked then the receiving mail server may choose to accept the message even though the SPF record does not match.34 .

Changing MX Records Learn how to redirect where your mail is managed.72 (C) 2012 Surpass Hosting .34 . cPanel Guide 11.

If you have any questions or issues.Managing your MX (Mail) Records This feature is an advanced one that we do not recommend that you try to use unless you know what you are doing. please contact support for assistance.34 . The wrong setting here could break mail delivery for your domain.73 (C) 2012 Surpass Hosting . cPanel Guide 11.

74 (C) 2012 Surpass Hosting . You can set this up by clicking on MX Entry on the cPanel home screen. Make sure you have an MX record set up for the remote mail server or no mail will get delivered.34 . When mail servers are looking to deliver mail to an account. There is a primary mail server that is where mail will normally go to and then there are secondary servers that will accept mail for your domain if the primary server is down. This continues until the sending mail server cannot find any more mail servers or it manages to deliver the mail. This feature can modify the mail (MX) entries in the DNS Zone for your domain(s). they look up the MX (Mail eXchanger) records for the domain. In the Email Routing section. in certain cases.cPanel typically handles your mail for you. You should use cPanel to create/edit email accounts and forwarders if mail is being handled locally. If you have a remote server as your primary mail server. This option also displays what cPanel currently thinks it should do with mail for your domain. (4) Backup Mail Exchanger: cPanel now supports having our server act as a backup (secondary) mail server. If it says "remote" then that means that cPanel thinks your main mail servers are hosted somewhere else and cPanel will pass all mail off to the remote mail server. The way this works is mail gets handled by the remote primary mail server. The sending mail server then tries to connect to the mail server with the lowest MX record number and will deliver the mail there. (3) Remote Mail Exchanger: This forces cPanel to try to pass off mail to a remote mail server. just as it would if you chose Remote cPanel Guide 11. If it says "local" then cPanel is managing your mail itself. However. If that mail server doesn't respond or denies the mail then the sending mail server will try to connect to the mail server with the next lowest MX record (if there is one) and will deliver the mail there. you may prefer to have a third-party service manage your mail or even add backup mail service. cPanel will try to automatically figure out if the primary mail server for your account should be our server or a remote server. You can also explicitly set the behavior if you think cPanel's automatic detection isn't working (or if you want to make a temporary change in how mail is handled): (2) Local Mail Exchanger: This forces cPanel to try to manage your mail locally (on your server). do not try to use cPanel to manage your mail accounts or use cPanel's webmail service. you can set the following actions for cPanel: (1) Automatically detect configuration: This is the default setting and the one you typically should keep. You will need to manage your mail on the remote mail server.

If it is working. If you make a mistake. You can click the appropriate link to delete or edit the existing record if you wish. cPanel will notify you of the problem so you can fix it. If you choose this option. then you should selected Automatically Detect Configuration or Local Mail Exchanger and then set up another MX record for the backup mail server(s) with higher MX numbers than your primary mail server. You can specify any non-negative number you like. Select this option only if you are going to use our server as the backup mail server. Below that is the Add New Record section.works is mail gets handled by the remote primary mail server. the mail server must have a fully qualified domain name associated with it (per RFC guidelines). The (7) Destination is the mail server host name that you want to deliver mail to. if the main mail server fails for some reason and is not accepting mail. At the bottom of this screen.75 (C) 2012 Surpass Hosting . just as it would if you chose Remote Mail Exchanger.34 . then our server will send the stored mail for your domain back to the primary mail server. Lower numbered MX records are used first. please contact support and do not change anything on this screen. By default. You cannot use an IP address in this box. however. This allows you to add additional MX records to your domain's DNS zone(s). followed by records with higher numbers. NOTE: If anything described here confuses you. cPanel Guide 11. don't forget to click the (5) CHANGE button to apply the new setting. Click (8) ADD NEW RECORD to add a new MX record with the details you specified. If you are using a third party (remote) mail server as your backup mail server for your cPanel account. then the mail will be delivered to our server. cPanel sets a MX record with a value of zero pointing to the local mail server (so cPanel will manage your mail). or if you are in any way uncertain how to proceed. The (6) Priority number sets the order in which other mail servers will use the mail server specified in this record. all of the (9) MX records that are currently set up will be listed. Our server will periodically check to see if the primary mail server is back online and responding. If you change the default Email Routing selection. so long as you make sure the lowest numbered record is the mail server you want to primarily handle mail for your domains. then you need to set up your mail accounts and forwarders the same as you have them set up on your primary mail server so our server knows how to handle the mail. This provides redundancy in case there are problems with your main mail server.

34 .Working with Files cPanel Guide 11.76 (C) 2012 Surpass Hosting .

Thankfully cPanel makes it much easier to back up your data and cPanel Guide 11.77 (C) 2012 Surpass Hosting . We cannot stress this enough. Backing Up and Restoring Data It is important that you always keep your important data backed up.Backing up and Restoring Data Learn how to use cPanel to backup and restore your important data.34 . This is especially true of the content of your web hosting account. please keep your important data backed up at all times.

Each one will note when it was made so you can distinguish them. Although full backups are the most complete record of your data. select a backup destination (the choices are storing the backup in your home directory (not in your web root). This will take you to a new screen. However. the backup is generated in your home directory. they do have two drawbacks: * You cannot use cPanel to restore a full backup: Because the full backup contains data from more locations than what is stored in your home directory. Simply click on a listed full backup file to download it to your local machine. our support personnel have the ability to restore full backups that are provided to us. To generate a full backup manually. click the (1) DOWNLOAD OR GENERATE A FULL WEBSITE BACKUP button. then the backup will be removed from your home directory once it has been sent.restore it should something go wrong. On the full backup screen. Also. When you are ready to backup your files or if you need to restore data from a backup. NOTE: No matter what destination you choose. * They take a long time to generate and place high load on the server while they are being generated: Full backups can contain a lot of data and creating the compressed backup can put stress on even the most powerful servers. Here you can choose from making or downloading full backups of all of your data or downloading or restoring key parts of your data. you can manually decompress a full backup file and manually reload most of your data. If you choose to send the backup file to a remote server. select Backup from the cPanel home screen. all of your data stored on our server compressed and provided to you as a single file you can download locally or transfer. Full backups are just what they sound like. For this reason we strongly recommend that you take backups during off-peak hours when load is low on the server so you don't inconvenience other users on your server. To generate or download a manual full backup. you will be shown any full backups that you've generated in the past that are stored in your home directory.34 . cPanel Guide 11. so you will need 50-75% more disk space available in your hosting account than you are currently using or you risk running out of space in your account. if it is critical.78 (C) 2012 Surpass Hosting . or sending the file to a remote server via FTP or SCP (secure copy). cPanel cannot automatically restore a full backup.

the backup will take a long time and eventually you will be prompted to save the compressed backup to your local machine. except for MySQL databases. click the BROWSE button under the Restore a Home Directory Backup heading. then you will be prompted to enter the data needed so that cPanel can log into your remote server to save the file. The Home Directory backup allows you to backup all of the files located in your account's home directory (that is. The backup will be made in the background without further interaction needed from you. Select the compressed home backup you want to restore. the backup restoration will fail. With the exception of Mailman mailing lists. If you are restoring a lot of data.If you choose to save the backup in your home directory. Do not navigate away from this screen until the restore is complete. this can take a while. click the (3) HOME DIRECTORY backup button. Click the appropriate (2) button to start downloading the most recent daily or weekly backup we have made. If you ever want to restore the contents of your home directory from a home directory backup you've made in cPanel. If there is a lot of data in your home directory. This will backup most of your data. you can download all of that other data in separate compressed backup files. The Partial Backups section of this screen offers you the ability to backup and also restore compressed backups of your critical data.34 . the server will decompress the backup and restore the files. Your web hosting account needs 50 . Don't forget to choose whether you want to receive an e-mail when the backup is complete or not and then click GENERATE BACKUP to start the process. Back on the main Backup screen. If your account hits your disk quota limit. To start the backup process.75% more space available than your account is currently using if you want to restore the backup. cPanel Guide 11. When done. If you choose to get an e-mail when the backup is complete then cPanel will send you an e-mail with the results of the backup so you know if it worked or not. then click the (7) UPLOAD button to start uploading the file from your computer to your web hosting account. the location you access with your main FTP account. you can also choose to save some time by downloading a copy of the backups that we make each night. then make sure that option is selected from the drop-down list and then enter your e-mail address if you want to be notified when the backup is complete and click GENERATE BACKUP. If you plan to send the backup to a remote server via FTP or SCP. We generally backup every account on our servers every night and we keep one nightly (daily) backup and one that is up to a week old (weekly). This is normal. Email aliases and filters and Mailman mailing lists. Note that not all cPanel accounts will see the System Backups section. usually /home/YOURCPANELUSERNAME).79 (C) 2012 Surpass Hosting .

sql file. Do not navigate away from the page until the upload and restore is complete. restoring the mail filters settings to the state they were in when the filters were backed up. just upload the file in the Restore Email Forwarders section. There may also be a database listed that is just your cPanel username. If you use the E-mail Forwarders feature in cPanel. button and select the backed up e-mail forwarders file then click on the (10) UPLOAD button to restore your settings. decompressed and the settings in the file applied. cPanel Guide 11. Click the BROWSE. Each of your databases is a separate download.. As with all restores. or you may damage your database. The file will be uploaded. The file will be uploaded. When you need to restore the settings you've backed up. Click the BROWSE. you can backup any e-mail filters you may have created by clicking on the (6) (sub)domain name in the Download Email Filters section. This process should not take very long. decompressed and the settings in the file applied. If your account hits your disk quota limit. This process should not take very long. please contact support for assistance with restoring your database. To back up the databases your account is using. The file will be small and will download to your local computer. but do not navigate away from this page until the restore is complete. To restore the mail filters from your backup. click the BROWSE button under the Restore a MySQL Database Backup section. Finally.. If you would like to restore one of the databases you've backed up. That database is used by cPanel/MySQL and will likely not contain much data (if anything).34 . cPanel may have problems restoring the database. This is normal. If you still have problems. If this happens.. upload the file in the Restore Email Filters section. but do not navigate away from this page until the restore is complete. upload your uncompressed database to your cPanel account and then use a script like Big Dump to restore the uncompressed . Choose the database you want to restore from your computer and then click the (8) UPLOAD button to restore the database. button and select the backed up e-mail forwarders file then click on the (9) UPLOAD button to restore your settings.. please make sure you have enough available disk space to handle both the compressed backup file and the uncompressed file (typically 50-90% larger than the compressed backup).80 (C) 2012 Surpass Hosting . click on the (4) database name listed in the Download a MySQL Database Backup section. you can backup all of the forwarders settings for each domain in your cPanel account by clicking on the (5) (sub)domain name.want to restore the backup. That will save a small file to your local machine that contains any mail filters you've set up. restoring the forwarder settings to the state they were in when the settings were backed up. the backup restoration will fail. If your database is very large.

Click on either the BACKUP or RESTORE buttons to continue to the next screen.34 . but you cannot use cPanel to restore the backup (someone from support would need to do that). cPanel has your back(up). On the first screen of the wizard. As discussed earlier. to a partial backup is that you can use cPanel to restore the backed up files including MySQL databases. you select whether you want to backup or restore files. you will be taken to a screen where you can select where the compressed cPanel Guide 11. If you select full backup. don't worry. Partial backups contain most of your data.81 (C) 2012 Surpass Hosting . email and web site files. however. This wizard will simplify the steps it takes to backup or restore your website. partial backups do not get any mailman mailing list data you may be using).The Backup and Restoration Wizard If all the steps in the previous discussion about backing up and restoring files have frustrated or confused you. full backups include 100% of your data. :) Click on the Backup Wizard icon on the cPanel home screen. If you choose to backup your files. The benefit. but not all of it (for example. you will then be taken to a screen where you will choose either a full backup or partial backups.

If you choose partial backups. You can choose your entire home directory (this includes all of your mail and web files). You can only restore partial backups. cPanel Guide 11. you will be asked what sort of backup you want to restore. You will also be able to set an e-mail address to get notified when the full backup is complete.82 (C) 2012 Surpass Hosting . You will be prompted to locate the compressed backup and then cPanel will get to work decompressing and then restoring your data. so be patient.34 . especially when transferring them to a remote location can take time. Full backups.backup gets sent when ready. you will then be asked to select what part you want to backup and download. so when you choose to restore a backup. Note that this process may take quite a while and you should not navigate away from the restore page until the restore is complete. home. mysql or e-mail filters and aliases. the MySQL databases (each gets backed up and downloaded separately) or e-mail forwarders and filters (backed up and downloaded separately for each domain/subdomain). either into the account's home directory or sent via (S)FTP or SCP to another server.

cPanel Guide 11. but the Legacy File Manager works nearly the same way for most functions. The first. Currently. The screenshots and descriptions in this guide illustrate the standard File Manager. Feel free to use which ever version you prefer.83 (C) 2012 Surpass Hosting . written using less javascript. you will be prompted for the location you want to open initially. just called File Manager on the cPanel home screen is the newer version of the tool that works best with modern browsers.34 . It may work better for older or mobile web browsers. The other version. called Legacy File Manager on the cPanel home screen is an older version of the tool. they are basically the same.Part 1 Using an FTP client isn't the only way to add. The File Manager . there are two different versions of the same file manager tool available in cPanel. It uses more javascript to make working with the file manager more intuitive.The cPanel File Manager Learn how to use cPanel to upload. delete or modify files in your web hosting account. One of the alternate ways you have to work with files in cPanel is to use the file management tools built into cPanel itself. When you click on File Manager. download and edit files in your account. This is very handy if you need to make a few quick changes and are in cPanel already.

You select the available choices from a drop-down list..Your choices are: 1) Your home directory (/home/CPANELUSERNAME/) 2) The web root (the main location for web-accessible files /home/CPANELUSERNAME/public_html/ . then make sure the checkbox next to Show Hidden Files (dotfiles) is checked (5).84 (C) 2012 Surpass Hosting .This is the default) 3) The main publicly accessible FTP directory if anonymous FTP access is enabled (/home/CPANELUSERNAME/public_ftp/) 4) The main web document root for a particular domain or subdomain). If you want to have cPanel show you hidden files (on Linux servers.34 .) get hidden from display by default)." (6). If you would like cPanel to remember your choice the next time you open the file manager (making the current selection the default from now on) click on the checkbox next to "Skip this question. any files starting with a period (. cPanel Guide 11. click Go (7) to access the File Manager itself. Finally..

there is only a single option.34 . you click that to change general settings related to file management. Just below that section are the (3) file manipulation options. you will see a tree showing all of the directories on your site. Click on any of these icons to perform the action (on the selected files/folders). to disable the file character encoding warning dialog boxes that appear when you try to edit a file.The File Manager . Click on the small + or . On the right-side of the screen. maximum. On the left side of the screen is a (2) search box that allows you to look for file names containing the string you type. be as specific as you can when searching. is a bar containing a link to the general (1) File Manager Settings.85 (C) 2012 Surpass Hosting . Click the Collapse All item at the top of the list to "roll up" all of the folders so that only your home directory itself is shown in the list. The search is limited to 250 results.symbol next to a folder icon to show or hide the contents of that directory. Click on the name of a directory to go there (the contents will be displayed on the left side of the screen).Part 2 The File Manager opens into a new window and as you can see from the screenshot above looks and works similarly to many other file management tools you may already be familiar with. Right now. At the top of the screen. cPanel Guide 11.

html. The delete icon will prompt you to delete the selected file(s) or folder(s). You will first be asked to confirm the encoding of the file. If you need to edit a text file. . essentially duplicating the content in another location). In either case. You can also switch back and forth between the code editor and the plain text editor without having to reload or save the file. The rename icon will allow you to change the name(s) of the selected item(s). Don't forget to empty the trash if you are using the Legacy File Manager and you need to clear up disk space. If not. Select the appropriate cPanel Guide 11. You can then choose to restore the file from the trash in the sidebar on the right side or click the trash can icon to permanently delete the file(s) or folder(s).e. The Edit icon simply brings up a text box with the content of the file you've selected.Trash directory in your account.34 . Then you need to specify the new location. then click the appropriate action icon from the bar near the top of the screen.86 (C) 2012 Surpass Hosting . but each is tailored to a specific type of file. If you want to close the window without saving your changes. In the case of files. You will be prompted for the name of the file or directory.To the left is the current directory content display. When you are done. the file will be deleted after you approve the deletion.php) if needed. All three are used to edit files from within your web browser. . If you want to edit raw HTML or PHP code. Then there are three different edit icons. Click on the file(s) or folder(s) you want to act on. leaving the original in place. then this is probably your best choice. On the Legacy File Manager. You can edit the content in plain text and save changes as needed. click the CLOSE button. click SAVE CHANGES. if you didn't choose to have the File Manager display them). of course). In the standard File Manager. make sure you're creating the file or directory in the location you really want it. The move icon will attempt to change the location where the file or directory is located. You can create a brand new file or folder in the current directory by clicking on those icons. the file or directories will be moved to a special hidden . Use this icon if you aren't sure what sort of file you are dealing with (this won't work for binary or encoded files. The Copy and Move icons will attempt to make a copy of the selected items (and anything inside any directories you have selected). be sure to add the extension (i. You do this by filling in the full path to the new location and you can even specify a new name for a file or directory if you are only moving/copying one. The upload and download icons allow you to upload or download files to or from your account.. feel free to edit the path to the file or directory and it will be created in the new location. This shows all files and directories (except for hidden ones. then it is usually best to select the Code Editor icon on a selected file.

The Change Permissions icon will allow you to change the permissions of the selected file(s) or folder(s). In addition to ownership by individual accounts.) but if you get a warning when you open the HTML Editor that your browser is unsupported or if it opens a window with nothing but a plain text field and no icons.34 . You can select the permissions by clicking on check boxes for the appropriate settings you want or by manually typing in the 3 number code corresponding to the permissions you want to set.87 (C) 2012 Surpass Hosting .a selected file. Firefox 4+. fonts. Let's take a moment to discuss Linux file permissions in case you aren't familiar with them. It primarily uses two things to keep track of who can access what files: Ownership: Every file and directory on a Linux server is "owned" by some user and assigned to some group. Alternately. click on the small Save icon that looks like an old. You will first be asked to confirm the encoding of the file. To Save your changes to the file. This will bring up the code in the file you select for editing and that code will be syntax colored based on what language the code editor believes you are working with. That will show you the syntax colored code similar to the Code Editor. Linux was designed from the start with multiple users in mind. You can also switch back and forth between the code editor and the plain text editor without having to reload or save the file. If you decide you'd like to edit the HTML code directly. If you would like to edit your HTML pages in a WYSIWYG environment (the page looks similar to how you will see it in your web browser. blue floppy disk. You can select a different code language for the syntax coloring feature from the bar at the top of the window. Select the appropriate encoding if the listed default is not correct. just close this window. then you will be presented with the contents of your page open in design edit mode. including formatting and graphics) then select the HTML file and click on the HTML Editor icon. If your web browser is supported by the HTML Editor. If you want to close the window without saving your changes. then click on the PREVIEW button at the bottom of the screen. When you are done. etc. click the CLOSE button. Safari 5+. every directory or file can also be assigned to a group. then you will need to use a different web browser in order to edit your content. click SAVE CHANGES. This includes formatting. If you don't want to save your changes. Your cPanel username is your "system user" on our Linux server. If you'd like to see the page as it will appear in your web browser. click on the SOURCE button at the bottom of this window. NOTE: The HTML Editor supports most recent versions of the major web browsers (IE 8 or 9. try the Code Editor instead. A group is a collection of one or more system user accounts that are to be allowed special access to the file cPanel Guide 11. You can make changes to your page using controls that are similar to older versions of Microsoft Word (tm). images and other media.

if the Owner of a file is allowed to Read. World = 0+0+0=0). Execute) are assigned a different "point" value. Write and Execute it and the Group can only read and execute the file and everyone else (World) isn't allowed to do anything with the file.is a collection of one or more system user accounts that are to be allowed special access to the file or directory. * Write: Anyone with write permission can add or change content inside a file or directory. * Execute: Anyone with execute permission is allowed to "run" the content inside the file or directory. Group = 4+1=5. Group and World. This returns a 3 digit number from 000 to 777 that completely expresses who can do what to that file or directory. The numbers get added together down the column for Owner. For example.88 (C) 2012 Surpass Hosting . Linux also keeps track of those things that people who aren't the owner and who aren't in a group assigned to the file or directory should be allowed to do with it. cPanel Guide 11. then the numeric expression of the permissions on this file would be 750 (Owner = 4+2+1=7. The combination of ownership and permissions allowed for a file are displayed in a table like this in the File Manager (and in most other programs that let you edit Linux permissions): Read Write Execute Owner Group World [] [] [] [] [] [] [] [] [] # # # Down the first column are the permission settings for the file and across the first row are ownership settings (World = everyone else who isn't the owner of the file or directory or in the assigned group). Each of the three different permission types (Read.34 . Permissions: Linux keeps track of what everyone should be allowed to do with a file or directory. Permissions are broken down into 3 categories: * Read: Anyone with read permission can look at the contents of a file or directory. These numbers are a "shorthand" way of expressing Linux permissions. Write. Read is 4. In each row and column there are check boxes that allow you to set the permissions for each class of system account. As you check off permissions for each item. Write is 2 and Execute is 1. you will notice that there are numbers in the bottom row that change automatically.

write and execute the file or directory and everyone else can read or execute the content.gz) files are most common on Linux and that compression type is best if you are moving the files to another Linux server. write and execute permission. 755 = The owner can read.bz2 files. Save changes to set the new permissions. but not write to it.34 . Back to the main File Manager icons.tar.gz or . The final two icons. This is the standard permission setting for new directories. Without suPHP. Extract and Compress work on archives of files.zip is the most common compression type and PCs and Macs can both deal with those files natively.zip as it is the most common. cPanel will attempt to decompress the file and place the contents into the current directory (or where ever you specify).gzip (or . You must specify the final archive name and location as well as the type of compression you want to use. you should never set a file or directory to 777 permission. cPanel Guide 11. . PHP scripts run as your cPanel user. . suPHP will not allow any files or directories to be set to 777.The most common permissions are: 644 = The Owner can read. Some web scripts may tell you they need certain files or directories set to 777 permissions. This is the standard permission for new files and is fine in most cases. Most computers require additional software to be able to decompress this sort of file. and in some hosting environments they do.tgz) and . This is handy if you just want to read a file and want to make sure you don't accidentally make changes. 777 = Everyone can read.. If you are uncertain what sort of compression to choose. This is insecure. and write but not execute the file and everyone else can only read the file but not write or execute it. Gzipped (or tar.89 (C) 2012 Surpass Hosting . Since our servers use suPHP. In the File Manager. so 755 grants them read. select . write and execute the file or directory. Compress will take the selected files and directories and try to create a single archive out of all of them. set the permissions to 755 instead. Bzip2 files usually take the longest to create. The View icon allows you to view the contents of a file. It does not include editing of any kind. Why does this work? With suPHP. If you upload a compressed archive and select it in the File Manager and select Extract.. you can either set permissions by checking the check boxes in the displayed grid OR you can type the numeric permission into the three boxes at the bottom of the grid. If a web script needs to be able to read write and execute a file or directory. The File Manager typically supports . the PHP script will generate a 500 or 403 error when trying to access that file or directory. PHP scripts run as the user "nobody" and that is why they need 777 permissions. but generate the smallest final archive. If you do set them that way.zip.

90 (C) 2012 Surpass Hosting . the File Manager is fairly full-featured. then using FTP or WebDAV may be faster.As you can see. if you plan to upload or work with lots of files. However.34 . cPanel Guide 11.

From there. cPanel Guide 11.Using WebDAV (Web Disk) Learn how to use WebDAV to work with files in your account. cPanel also supports WebDAV (also known as Web Disk).91 (C) 2012 Surpass Hosting . you can work with files in your web hosting account as if they were all hosted locally. Welcome to WebDAV (Web Disk) In addition to providing FTP access to your account and a browser-based file manager. WebDAV is a newer protocol that allows you to mount your remote web hosting account as if it were a local hard drive (on OSes that support it).34 . using whatever tools you like.

By default. For example. though some may require additional software To start working with WebDAV. This default account cannot be restricted or removed and the password always matches that of your cPanel account. specify the WebDAV access directory. Although this looks like an e-mail account address.34 . keep in mind that anything a user uploads will be publicly available via the web. Finally.com.92 (C) 2012 Surpass Hosting . you can create WebDAV accounts or manage existing ones. it is not and should not be mistaken for one. giving access to the public_html/blog directory will give this user WebDAV access to the blog directory inside your public_html directory in your account (and any other directories inside the blog directory) but it would not give this user access to public_html itself or your home directory via WebDAV. If you are granting access to public_html or to a directory inside public_html or some other web root location. Please be sure to use a secure password or use the Password Generator feature to create a random. you can choose to create other accounts with different access permission. This new account will have access to the directory specified here and anything contained within that directory. every cPanel account comes with one WebDAV account set up. so make sure you keep your cPanel account password and username private and secure. click on Web Disk on the cPanel home screen. On this screen (shown above).NOTE: Most operating systems support native mounting of WebDAV directories. The login will be whatever username you enter @ your domain name. secure password. cPanel will try to warn you if it detects you are trying to create an account with access in this area and remind you to set up password protection for that directory if you want to keep the content cPanel Guide 11. These accounts you create can be added or removed at will. However. Perhaps you have someone who manages your website for you. This account uses the same login information as your main cPanel account (the cPanel username and password) and it gives you full access via WebDAV to all of the files hosted in your cPanel account. If you want an e-mail address go to the Email Accounts feature on the cPanel home screen to create one. Example: test@domain. so you can create an account that only provides them WebDAV access to public_html (your account's web root) without letting them access the files in your home directory (/home/CPANELUSERNAME/). To create a new WebDAV account fill out the details in the (1) Create Web Disk Account box.

check the manual WebDAV instructions in cPanel or those listed below. Enter it and a few moments later the WebDAV directory should be mounted as if it were a local hard drive on your computer. Click GO to download the application and run it and it will prompt you for your password. If the application doesn't work.and remind you to set up password protection for that directory if you want to keep the content private. you can try to connect manually using the following information: Domain: YOURDOMAINNAME.COM (you could also use the IP address of your site if you wish) SSL Port: 2077 (connect securely to your WebDAV account using SSL . If that directory does not already exist. This will either be your cPanel username or SOMENAME@YOURDOMAINNAME.34 .COM.COM part). Each login is listed along with the starting directory for each account. The (2) ACCESS WEB DISK button brings you to a new screen when you can download small programs for each supported OS that makes it much easier to mount the WebDAV disk on your local computer so you can access it. the default directory for the account and various features related to account access and management.) Username: The login listed in the Web Disk Account Management section on the WebDAV screen in cPanel. This shows you all WebDAV accounts that are currently set up. On this new screen. The main WebDAV account cannot be removed or changed in any way. cPanel will create it once you click the CREATE button. delete the account or password protect the directory so others cannot access it via a web browser without the username and password. in the (3) Actions section. Finally. Password: The password assigned to the account you are trying to access Make sure that your local firewall or router (if you have one) allows connections on port 2076 and cPanel Guide 11. By default. Connecting manually to a WebDAV directory: If the application to connect to your WebDAV account isn't working. cPanel will set the directory to public_html/WEBDAVUSERNAME/ where WEBDAVUSERNAME is the username you specified earlier (without the @YOURDOMAIN.93 (C) 2012 Surpass Hosting . you can change the password for this WebDAV account. select your OS from the drop-down list and make sure the SSL checkbox is selected if you want to connect securely (which we recommend). Example: Creating a "test" account will default to granting access to public_html/test/.RECOMMENDED) Non-SSL Port: 2076 (connect without SSL. This is insecure and not recommended unless you are having problems connecting via SSL . The password always matches the password for your cPanel account. At the bottom of this screen is the Web Disk Account Management section.In fact our servers may not permit you insecure access.

Those changes will be immediately reflected in your site (unless the content is cached by the browser. Mac OS X uses ". where they may become visible (on Linux. since Linux does not need or require this information and it may be a security risk to leave in place.DS_Store" files to keep track of window settings and other file metadata. of course)." is hidden by default. an example of this is the Thumbs.Make sure that your local firewall or router (if you have one) allows connections on port 2076 and 2077 or you won't be able to use cPanel's WebDAV feature. cPanel Guide 11. Windows and the Mac OS may copy these hidden files to your hosting account. Both Windows and Mac OS use special hidden files to keep track of certain OS level information. On Windows. but all other files or directories are visible. When you have your Linux-based hosting account mounted on on your computer. any file/directory that starts with a ".db file that Windows creates to display thumbnails of pictures stored on a Windows machine. NOTE: If you have a WebDAV account mounted as a disk on your local computer.94 (C) 2012 Surpass Hosting . You may need to clean out these special files from your hosting account.34 . keep in mind that changes you make are being made to your "live" account.

Monitoring Disk Space Usage Learn how to check your account disk space usage.95 (C) 2012 Surpass Hosting .34 . If you're getting close to your limits or you think you may want to clean out older files to free up some additional space. The directory using the most disk space will be shown with a full bar and other directories will be shown with bars that are less full depending cPanel Guide 11. Account Disk Space Usage cPanel helps you keep track of the amount of disk space your hosting account is using. the first being bar graphs showing the directories containing the most data in your account. This feature generates two sets of data. then accessing cPanel's Disk Space Usage feature from the home screen is a good idea. The bar graphs are plotted relative to the directory currently using the most disk space in your account.

cPanel Guide 11.34 . So if your account is using 100 MB of space. if your public_html directory uses 30 MB out of 100 MB.96 (C) 2012 Surpass Hosting . total. You can click on the name of a directory to be automatically taken to the cPanel File Manager with that directory displayed (where you can add/remove or edit files as needed. only the totals for each directory). and your mail directory has 60 MB of data and all the other directories in your account use 40 MB of disk space. and other directories will show less. The second set of data (shown above) displays a list of all of the directories in your account. the mail directory will show a full bar. NOTE: cPanel caches the amount of disk space your account is using because keeping track of the value can place a burden on the server. For example. and the public_html directory is half that size. This means that if you make changes that affect the disk space in your account (adding or removing files) those changes may not be reflected in cPanel for 10 minutes or so.on how much disk space they use when compared with the directory currently using the most. If you want to drill down in the list to see what other directories are using inside one of the top-level directories listed. then click on the (2) small + icon next to each directory. Note that the display doesn't show individual files. sorted either by their names or by how much disk space they are using (you select how they are sorted at the (1) top of the list). Every directory is listed by the amount of Megabytes (where 1 MB = 1024 bytes) and bytes are contained within the directory. then the bar would be half full because the largest directory is 60 MB. A full bar in this graph does not mean that the directory itself is full.

97 (C) 2012 Surpass Hosting .File Transfer Protocol (FTP) Learn how to manage FTP access in cPanel. cPanel Guide 11.34 .

FTP stands for File Transfer Protocol and it was designed many years ago to transport files and information between two computers.Creating and Managing FTP Accounts The most common way people add files to their web hosting account is via FTP. Most web design software supports using FTP to upload or download cPanel Guide 11.34 .98 (C) 2012 Surpass Hosting .

The user interface may be a bit daunting for new users. The full username will be username@yourdomain. Popular FTP Clients: Cyberduck: http://cyberduck. even if you have more disk space available to your hosting account). If you have more than one domain or subdomain assigned to your account.ch/ Cyberduck supports a wide variety of file transfer protocols. click (5) CREATE FTP ACCOUNT to tell cPanel to create the account. NOTE: The directory that will serve as the home directory for the FTP account will be created if it does not already exist. the content in that location will not be modified. This will take you to a screen similar to the one shown above. FileZilla: http://filezilla-project.com is your domain name. but the account will not be able to access anything in /home/domain/ since that directory is "below" public_html. That FTP user will be able to access all content inside the home directory (path) including all of the directories inside that directory. create a new FTP account. The (3) home directory (or path) is the directory that the account will start in upon initial login. Donations of any size are encouraged.COM) it is not. If you cPanel Guide 11. Finally. To start the process you enter the (1) login username. you can do just that. you will also be able to select that domain or subdomain from a drop-down list here. then feel free to change it. If you set it to unlimited quota. That FTP account will have full access to any existing content in that location. Select the (4) disk quota for this account (the FTP account will not be able to add more content to this location then you set. Google Docs and more. It can also handle WebDAV. click on FTP Accounts on the cPanel home screen.34 . then that FTP account will be allowed to add files to its home directory (path) until you run out of disk space assigned to your hosting plan.com where yourdomain. If you don't like the suggested path. In the Add FTP Account section. That is because the data you send and receive using FTP is not encrypted in any way during transport. cPanel will automatically suggest a location to serve as the home directory for this FTP account. although the FTP account username looks like an e-mail address (with the @YOURDOMAIN. To manage or create FTP accounts. If you require a secure connection. Both require some additional setup and consideration and will be discussed later. FTP is not considered a secure transfer protocol. This free program works on Mac OS X and Windows. Windows and Linux. Also. Then you enter a (2) secure password two times (or use the Password Generator.99 (C) 2012 Surpass Hosting .files. not just FTP. but if it does exist.org/ The free FileZilla client only supports FTP (and related) file transfer methods. So if the path is /home/domain/public_html then that FTP account will be able to access everything in public_html or any of the directories inside public_html. then you will want to use SFTP or FTPS. but it supports Mac OS X. Amazon S3.

If your domain name has not yet resolved to our server. followed by the (7) home directory for that account (the path).100 (C) 2012 Surpass Hosting . the small bar under the quota limits will fill up as the account gets closer to the quota limit you set. General FTP Account Details: When you want to access a FTP account you've set up. You are shown the (6) full username of the FTP account.COM is your domain name). If you are unsure or experience problems. If you are trying to access your main FTP account. set the transfer mode of your FTP client to Binary and try the uploads again. then use your cPanel account password. If the path is longer than the space allotted to display it. Next you will see (8) how much data this account has currently added to their path via FTP. there are a set of actions you can take on the account." Consult the manual for your program if you are unsure. then you can use the IP address of the server instead. you will need to create it separately in the Email Accounts section of cPanel.COM (if you are using the main FTP account. If you want an e-mail account with the same name. Transfer Mode: Usually Automatic is fine (the FTP client tries to pick the best transfer method depending on which sorts of files you are accessing) but some files (like encoded web scripts may require you to upload them in Binary mode. generally passive FTP connections are the most reliable since they don't require any special set up on your end. User: ftpusername@YOURDOMAIN.) Path/Directory: Some programs want to know where they should start when they upload files to your account. enter the path as /home/CPANELUSERNAME/public_html or sometimes just "public_html. the path will have an ellipse (…) that you can click on in the middle of the path showing that it is truncated. (11) deleting the FTP account and (12) a small draw down section showing the FTP account setup details. which also provides quick links to common cPanel Guide 11. This includes (9) changing the password. which for your main FTP account is your account home directory: /home/YOURCPANELUSERNAME/ but if you want it to start in the web root for your account. If you have quotas enabled for the account. then you should use your cPanel username instead. You can also perform certain administrative actions on each account in this section. (10) changing the quota limit. The FTP Accounts section shows you all of the FTP accounts currently active for this account that you've created in cPanel.) Port: 21 (21 is the standard FTP port) Type of Connection: Passive FTP (Although an active FTP connection may work.COM (where YOURDOMAIN. You can click on the ellipse to pop up the full path. you should set it up in your FTP client like this: Host: ftp. then the program will start in your FTP home directory.34 .YOURDOMAIN. Finally.COM) it is not.) Password: (Use whatever password you've set for the FTP account.account username looks like an e-mail address (with the @YOURDOMAIN. If you don't enter anything.

The password is the same as your cPanel account password. you can use your cPanel account details to do SFTP. you will be asked if you just want to delete the FTP account or if you want to delete the account AND everything inside the account's home directory (path).YOURDOMAIN. in order for this to work. This account also always has unlimited disk quota. Be very careful with this directory removal feature because there is no undo. select SFTP as the connection type and then enter ftp. It also works with FTP accounts you create in cPanel. they are located elsewhere on the server. SFTP: As mentioned earlier. and SFTP leverages that to transfer files via SSH. This account automatically gets full access to everything in your account. but if you want to process your logs locally with a special tool you've created or purchased.down section showing the FTP account setup details. then you need to use the Change Password feature in cPanel to change your cPanel account password. just delete the account and then manually delete the content using your main FTP account or cPanel's File Manager. the ability to access the server's Linux command line).COM (or the server hostname or your IP address) as the host and your cPanel username and password as the SFTP account username and password. This special account lets you download your own site's log files which otherwise would not be possible. Most clients that support FTP also support SFTP. This cPanel Guide 11. the login details for which match those of your cPanel account username and password. your account must be set up with SSH (Secure SHell) access (i. so it can upload anything up to the limit imposed by your hosting plan.COM FTP account to access and download those logs. The reason this account is necessary is that your domain logs are not stored in your account. If you want to change the password that this FTP account uses. When in doubt. encrypted. Once SSH access has been enabled for your account. which also provides quick links to common FTP clients as well as small bookmarks you can use to automatically connect the account in those FTP clients. The first is your main FTP account. but for SFTP transfers. Normally. To make such a connection.34 . FTPS/FTPES: There is another way to securely transfer files using FTP that does not require getting SSH access for your account. the port for FTP transfers is 21. you should use the SSH port you were told to use when your SSH access was set up. however. The second special account is one specially designed for you to be able to retrieve the raw Apache domain logs that show all of the hits your site has received.101 (C) 2012 Surpass Hosting . called SFTP (Secure File Transfer Protocol). by its very nature.e. NOTE: If you try to delete a FTP account you've set up.. cPanel does offer graphical stats programs. Typically there will be 2 accounts listed here. If you require it. there is a way to securely transfer files via FTP. please ask for SSH access. By default this is not enabled in your account. SSH access is. you use the domain_logs@YOURDOMAINNAME. The (13) Special FTP Accounts section shows all of the FTP accounts that the system has set up for you that you cannot alter.

cPanel Guide 11. Click the (1) RELOAD button to refresh the page to see if anyone is connected. This method is referred to as FTPS or FTPES (FTP with Explicit SSL). This version of FTPS uses a different FTP port number (990) than regular FTP or FTPES (21). FTPS uses a SSL certificate to secure standard FTP communications. If no one is currently connected to your account via FTP. there is a different type of FTPS that cPanel does not support. password and port are the same as FTP. but it has the benefit of working for all of the FTP accounts you create. Manage Active FTP Sessions cPanel allows you to monitor who is logged into your account via FTP. SFTP or FTP. To make matters a little more confusing. FTPS works differently. SSH. You must use either FTPES. so if you see the default FTP port change to 990 in your client. cPanel does not currently support FTP with Implicit SSL/TLS and there is no way to add it. It's not as secure as SFTP. SFTP relies on another service. but you need to tell your FTP client to use FTP with Explicit SSL/TLS (the exact wording may change depending on your FTP client). you will see some basic information listed here including the account being used. not just your main cPanel account. Despite the similar sounding name to SFTP. If someone is transferring files. To access this feature click the FTP Session Control item on the cPanel home screen.getting SSH access for your account. username. to encrypt all communications between your file transfer client and our server. you know you've selected the wrong type of FTPS. It also works with FTP accounts you create in cPanel. The configuration of the host. Most FTP clients that support SFTP also support FTPS. called FTP with Implicit SSL/TLS (or sometimes just FTP with SSL/TLS or FTPIS). you the screen will look as it does above.102 (C) 2012 Surpass Hosting . You can use this feature to disconnect users you think may be abusing your account or just to keep an eye on what is happening.34 .

103 (C) 2012 Surpass Hosting . If you don't like what you see. the current status of the connection. and the process ID. you can click the DISCONNECT link that appears next to that logged in user. However. cPanel Guide 11. This will immediately stop what the user is doing and kick them out of the server. either change the password for the account or remove it from the FTP Accounts section of cPanel.34 . the time they logged in. If you think the FTP account has been compromised.the IP address the connection is coming from. it won't stop them from coming back.

104 (C) 2012 Surpass Hosting .34 .Web Logs and Statistics cPanel Guide 11.

with the most recent hits cPanel Guide 11. If you want to increase the amount of hits shown on a single screen. this is a good way to keep an eye on important visitors without getting distracted with superfluous information. To edit the columns of data that are shown. cPanel provides you with a full suite of tools to monitor what is going on with your site. it is a labor of love or your business or both.34 . Changes are reflected immediately. you can use the (1) Search box to enter some of the information you are looking for. Every single access of any file or directory in your website gets logged automatically and the most recent hits will be displayed here with the most recent ones listed first. To take a look. If you want to refresh the list of recent visitors with the very latest information. removing unimportant data so you can focus on what you care about. cPanel will filter out the results that don't match what you've typed and display the rest.The Latest Visitors Log Learn how to view the list of the latest vistors to your website. click on the (3) gear icon and check or uncheck items as you see fit. If you are looking for specific information. click the appropriate number in the (2) entry number toggle. click the (4) refresh icon and the list will be instantly updated. If you have a very busy site. Here you can view all of the most recent hits on your website. The first of these tools is a simple interface showing you the most recent visits to your web site. If you want to make sure your site is getting the attention it deserves (and not getting the wrong kinds of attention) it is important for you to keep an eye on who is visiting your website and what they are doing while there.105 (C) 2012 Surpass Hosting . You can also turn on or off various pieces of information if you want. click on the Latest Visitors item on the cPanel home screen in the Logs section. The Latest Visitors Log Your site is important to you.

if this interface isn't working well on your current browsing platform. please see the FTP Accounts section of this guide to learn how to access the special domain_logs FTP account to fetch your full log file.106 (C) 2012 Surpass Hosting . you can click through the (5) pages of hits or use the first. cPanel Guide 11. If you'd like to see older hits.34 . NOTE: Not all of the hits from your entire raw domain access logs may be shown.once again at the top of the list. next or last links to jump to the appropriate section of the list. Also. previous. click the "less javascript" link at the bottom of this page to switch to a different log view that might work better for you. If you want to review the raw logs. especially if you have a lot of hits.

cPanel tracks that use and periodically updates logs that you can view in the Bandwidth item from the cPanel home screen. Under that. NOTE: It is important to understand that cPanel does not track 100% of the traffic to and from your cPanel Guide 11.107 (C) 2012 Surpass Hosting .Bandwidth Useage Logs Learn how to keep track of your bandwidth (transfer) to and from your account. you will see pie charts for all of the months we currently have data for. the past week and the past year. Click on the number of the day in the table to see graphs for the breakdown by hour for that day. Bandwidth Usage Logs Another important aspect of your site is how much traffic is traveling to or from your site (how much bandwidth you are using). At the top of the screen you see charts showing the breakdown of traffic for today. and click on it to be taken to graphs and a table that shows precise bandwidth use.34 . This area shows you visual graphs and tables breaking down how much traffic you are getting to and from your site on all of the monitored services (like your website. broken down by each day in that month. mail and FTP). Point at a pie chart to show the breakdown of use.

34 . Your actual bandwidth use as measured in your CORE account may be different. only the most common types of traffic.108 (C) 2012 Surpass Hosting . Contact support if you have questions about this.site. cPanel Guide 11. Also. Bandwidth processing is a very intensive task and so the graphs may only be updated every 2-24 hours (depending on conditions). bandwidth use is not updated in real time.

109 (C) 2012 Surpass Hosting . NOTE: You cannot compare the data from Awstats or Webalizer to each other or to the other cPanel log options. Awstats. none are more popular than the various web stats options cPanel provides. The purpose of the stats are to give you a more visual and organized view of the data your raw web logs provide. Each of them may interpret or display the data from your raw web logs cPanel Guide 11. what they were viewing. Click on the small magnifying glass icon next to the domain or subdomain you want to view stats for and that will open the stats display screen. Webalizer and Analog (you may or may not have access to all three). You may have access to up to 3 different stats options. you may be able to access many months of previous web stat data. You can see all the hits to your site broken down in a large number of different ways to find out who has been visiting recently. Looking at Web Statistics Of all of the various log options in cPanel.34 . To access them click on the Awstats or Webalizer/Webalizer FTP items on the cPanel home screen. Depending on your settings and how long you've had an active cPanel hosting account.Web Stats Learn how to view graphs showing vists to the domains managed by your cPanel account. where they came from and how much data they accessed while there.

please read the FTP Accounts section of this guide to learn how to access your raw web logs via FTP or use the Raw Access Logs feature in cPanel to download the compressed logs directly in your web browser. you can enable or disable it by checking or unchecking the box and clicking (1) SAVE. they are only updated at most every 24 hours. Here. If you disable a program and you later decide that you want to enable it again. Also. Alternately.differently. like Google Analytics . you will see a small lock icon instead of a check box. If an item displays a check box.com/analytics/ .34 .110 (C) 2012 Surpass Hosting . Choose Active Web Stats Logging Programs You may have the ability to control which. you may be able to use a free third-party service.google. They not only increase the load on the server while processing. you can choose to enable or disable any web stats programs that you are permitted to change. because generating the visual web stats is a very CPU intensive process.to get a more frequently updated graphic view of the hits on your site. any days that the stats program was disabled for will not be updated to show the stats for that program. Alternately. it may take 24-48 hours before you see the first update of statistics in that program. cPanel Guide 11. If it has been less than 12 or 24 hours since you disabled the program and you re-enable it. You can then feed the raw logs (which are always up-to-date) into a local copy of a web stats program. the stats for that day will be processed normally for that program. If you have many domains or subdomains managed in your cPanel account and you want to enable or disable one stats program for all of them. The only valid comparison of web stats are the results comparing the current month's data to previous months (if available) in the same stats program. If you need more frequent updates. Please be patient. if you are not allowed to change the setting for that stats program.http://www. but they also store quite a bit of data in your hosting account that may cause you to go over your disk space limits (if any). NOTE: If you enable a disabled web stats program. We strongly recommend that you disable any web stats programs you do not plan on using. click the (2) checkbox that appears next to the name of the stats program and click the SAVE button to apply the changes. if any web stats are run for your site by clicking on the Choose Log Programs item from the cPanel home screen.

Raw (Unprocessed) Web Logs Learn how to work with your domain raw access logs in cPanel. then the logs will be compressed and stored in your home directory after every time stats are processed (typically 24 . but you can use the Raw Access Logs item on the cPanel home screen to manage retention of or download those logs directly in your browser. don't forget to click the (3) SAVE button.34 . You can download your current raw log file by clicking on the name of the domain or subdomain in the (4) Download Current Raw Access Logs table. You can control this by clicking the check box to (1) archive your logs in your home directory and you can control if logs older than 1 month are kept by checking or unchecking the box next to (2) remove the previous month's archived logs. Raw Access Logs Not only can you use FTP to access your unprocessed (raw) site access logs. This will download a GZip compressed text file cPanel Guide 11. If you do. You can choose to keep more than your current raw access logs if you wish.48 hours). If you make changes.111 (C) 2012 Surpass Hosting .

The hits from these parked domains will be included in the raw logs as hits to the main domain. the compressed log size will be listed here (the uncompressed log is likely several times larger). cPanel Guide 11. If you have chosen to keep old log backups. Also. Click the name of the archived log listed to download it directly.to your device or computer. the last update will reflect the last hit date). The table also shows the last update entered to that raw log (if there have been no recent hits. If you have any parked domains linked to that domain. they will be listed in the (5) Archived Raw Logs section. then they will be listed under the Linked Domains section of the table.112 (C) 2012 Surpass Hosting .34 . if the logs use any significant disk space.

the IP address of the person or thing triggering the error and then a brief description of the problem. You can view the most recent 300 error messages by clicking on Error Log on the cPanel home screen.Account Error Log Learn how to view the most recent errors your account has experienced. so if you are having problems. if you wish. There is no link to download the errors. Your Account Error Log If Apache (the web server) notes any problems or errors related to your site(s).113 (C) 2012 Surpass Hosting . The most recent error is always listed on top. you may not see 300 error messages in this window. cPanel Guide 11. it will record them in an error log. If the error log has recently been rotated. The errors will list the date and time of the error (using the server's set time zone setting). The most recent 300 errors related to your web site or problems with web scripts will generally be listed here. but you can copy and paste them out of this window. this is a good place to look.34 . or your site is new. the note if it is an error or warning. That is normal.

114 (C) 2012 Surpass Hosting .34 .Security cPanel Guide 11.

Password Protected Web Directories There may come a time when you want some part of your site to be available on the Internet. but only accessible to a few key people. In this case click on the Password Protect cPanel Guide 11.34 . You don't want this part of your site getting indexed by Google and you don't want the public to be able to view it.Password Protected Directories Learn how to restrict access to web content using usernames and passwords.115 (C) 2012 Surpass Hosting .

password protection is NOT encryption. If that gets deleted by your web site creation software (or yourself) then you will need to recreate the password protection. You will be prompted to choose your starting location and then you will see a list of directories in that location. To set up a user. NOTE: If you have the Microsoft FrontPage extensions installed on your account you should remove them before trying to use this feature. incompatible method to password protect directories. Now the directory is not accessible unless someone knows a user name and password that you set up on this screen. but with a new password and that user will have their password changed to whatever you choose. Also. That new user will appear in the (7) Authorized Users box.Directories item on the cPanel home screen in the Security section. just fill in the Create User area using the same username as an existing authorized user. so right now no one will be able to access this directory. To enable password protection for this directory (and any other directories inside this one). To disable password protection for this directory. FrontPage uses a different. NOTE: If you want to change the password for an authorized user. Finally. The content inside the password protected directory is not modified in any way and the password protection only applies in a web browser (someone with a FTP or WebDAV account that has access to this directory will still be able to access and change the content without needing the username and passwords you've set up in cPanel. click on the (6) ADD/MODIFY AUTHORIZED USER button to create the user. Enabling or disabling FrontPage extensions on your site will wipe out any password protection you set up using this feature.htaccess and . You can delete a user by selecting the name from the Authorized Users box and then clicking on the (8) DELETE USER button. you should be aware that there are ways to manually remove the password protection. enter the (4) username and (5) password (or use the password generator to create a secure password) and finally.34 . click on the name of the directory (in the example above "test"). You haven't set up any users yet. then type in the (2) optional name you want people to see in their web browser when they are prompted for a username and password and then click the (3) SAVE button. They were end-of-lifed back in 2006 and are no longer supported by Microsoft. There is an . We do not recommend the use of Microsoft FrontPage or its extensions. click the (1) Password protect this directory checkbox. When you find the directory you want to password protect. just uncheck the checkbox and save changes. cPanel Guide 11.htpassword file created in the directory that is protected that controls access to the directory. This will bring you to the password protection screen you see. enter the details in the Create User section of this screen. Click on the small yellow folder icon next to a directory name to navigate into that directory to see other directories contained inside it or click the Up One Level link to go up to the containing directory.116 (C) 2012 Surpass Hosting .

Deny IP Address Web Access If you find one or more IP addresses that are causing problems for your web site (perhaps posting spam to the comment area on your site or trying to attack it. click on the IP Deny Manager on cPanel's home screen. To set this up. Any addresses that are blocked will be shown in the Current IP addresses being blocked section of this screen.34 . From here you can enter a single IP address or a range of addresses or even a domain name into the (1) text box and click the (2) ADD button. and they will no longer be permitted to access you website. then you can block them so they will not be able to connect to your web site at all. From there you can choose to remove any IP addresses currently being blocked by clicking on the small (3) X in the Remove column. Anyone who tries to connect to your web site from an IP address on the deny list will be shown a 403 (Forbidden) error instead of whatever content they were trying to access.117 (C) 2012 Surpass Hosting .Deny Website Access by IP Address Learn how to deny certain IP addresses from being able to access your website. You will be prompted to cPanel Guide 11.

adding too many IP addresses to the deny list can potentially slow down access to your site or create load issues on the server. please make sure you have a good reason and then contact support who can assist you. It does not block access by those addresses to some other services (like mail. so if you need to block a lot of IP addresses. the web server to deny the connections from those addresses. That causes Apache.confirm the removal and then the removed IP address or range will be permitted to access your web site again. please contact support for assistance. If you need to block an IP address completely from all contact with your site for some reason. Also. NOTE: This feature works by entering the IP addresses in a deny entry in the . for example).34 .htaccess file found in your public_html (main domain web root) directory. cPanel Guide 11.118 (C) 2012 Surpass Hosting .

SSH (Shell) Access If your account includes SSH access. it is possible to get SSH (Secure SHell) access to your hosting account. The first is cPanel Guide 11. your account does not come with this feature enabled. though if you need it. If you are not familiar with what this is. FTP and WebDAV are not the only ways you can interact with the content in your account. learn how to access and manage it. NOTE: Remember. then you likely do not need it.34 . Managing SSH (Shell) Access cPanel. This gives you a secure command line interface to your Linux-based hosting account. you can contact support to request it. you can manage the settings or even connect to your account directly from cPanel. For security. in order to use SFTP you will need to have SSH access enabled for your account.119 (C) 2012 Surpass Hosting . For particularly advanced individuals or those who need advanced features. All you need to do is to click the SSH/Shell Access item on the cPanel home screen to access these features. If you have SSH access enabled for your account. There are two primary ways of authenticating to gain access to your SSH account.

This is much more secure than just relying on standard password authentication. then someone would not only need your secret password.through a standard username and password. There are two different key types. you need both parts of the key as well as a secret password. the default is faster for the server to create. first click the (7) View/Download link in the Private Keys section. but you can leave the id_dsa name if you wish. the default value of 1024 is fine. if you click (1) Generate a new Key you will be taken to an interface where you will be asked what sort of key you want to create. If you don't know what to use. The key size controls how secure the key is and how hard it would be to "crack" if someone got a hold of the key. In addition. Remember this password. just leave DSA selected. and RSA takes longer to generate (but generally not too long) but will be faster when you authenticate with it. This size is secure and quicker to generate and to use. With standard authentication. remains on the server. DSA. Part of the key (the "public" part. with an encryption key. click on MANAGE SSH KEYS. manage the authorization status or upload an existing public key.34 . anyone to gains access to your cPanel username and password can gain access to your SSH account. meaning that the compromised key will no longer work. but we'll focus on cPanel's own implementation. Click the GENERATE KEY button to have the server create the new key. The private (secret) part of the key pair remains with you on your local computer or device. If you are going to be cPanel Guide 11. you must also know the secret password used to "unlock" the key pair and allow you to gain access to your account. they would also need to obtain a copy of your private key. To do that. From this screen you will be able to generate a new key. Your password should be long. It is not enough to have the two parts of the key. To manage your key settings. You can give this key any name you want. if you forget it then you will need to delete this key and create a new one to use. you can "revoke" the key and generate a new one. 1024-bit is the minimum value. Your SSH account username and password exactly match your cPanel account username and password. so make sure you keep those private and the passwords long and secure. you will need to get the private key onto the device you want to use to access your SSH account and you will also need to authorize your new public key for access to your account. Once the new key pair has been generated. A larger value is more secure but takes longer to generate and more time to use. secure and random and not the same as any other passwords you use. Each key you create should have its own name (in this case). if you think your key has been compromised.120 (C) 2012 Surpass Hosting . In order to gain access. However. Think of an encryption key like a real key that is broken into two pieces. if the login is restricted to a public/private encryption (SSH) key. If you don't have a preference. The second method of authenticating requires a public/private encryption key pair. There are lots of ways to generate a secure encryption key. At the top of this screen. how large the key should be and also be asked to enter the password you will use to access the private key.

first click the (7) View/Download link in the Private Keys section. 2) In the Finder. and the SSHPORT# is the port you were provided by us when we set up your SSH account.34 . unless you've generated other keys before. you can just click the DOWNLOAD button on this screen to save a copy of the private key to your local computer. place it anywhere you want. In a moment.That location won't be visible to you. 7) If you use the Terminal to connect then the connection string should look like this: ssh -l USERNAME YOURDOMAINNAME. 2) If you are unsure where to place the key. Generally. click on the Go menu and then select Go to Folder. but don't forget to specify the private key's location when you attempt to connect using the Linux/Unix terminal.) 4) A new window will open and it will probably be empty. Linux/Unix: 1) Save the private key file into the appropriate location for your chosen OS.COM is your domain name or its IP address. Don't forget the . Just enter the private key password into the box on this page and click CONVERT. needed because Windows does not have built-in terminal emulation like other OSes: 1) You first need to convert your private key into PPK format. 6) You will use the program of your choice or the included Terminal application (at /Applications/Utilities/Terminal.121 (C) 2012 Surpass Hosting . 3) In the window that appears. this is the format that PuTTY uses. cPanel includes a conversion process on the (7) View/Download screen for the private key.COM -p SSHPORT# (the USERNAME is your cPanel username and YOURDOMAIN. Windows using PuTTY. You can click the DOWNLOAD KEY button to cPanel Guide 11.To do that. a free terminal emulator. you need to place this key file into the correct location (or specify the location you are using when you try to connect with it).app) to make a connection once you are ready and the key is authorized. If you are going to be using a Mac or a Linux machine to access your SSH account. the PPK version of the private key will be displayed.ssh/ . 3) Use the program of your choice or the Linux/Unix terminal to make a connection once you are ready and the key is authorized. before the "ssh" part of the path. so you need to use the Finder's Go to Folder feature or the terminal to access this location.ssh (Where YOURSHORTUSERNAME is your Mac OS X user account name (the short version that is typically lowercase. type the path: /Users/YOURSHORTUSERNAME/. Mac OS X: 1) The correct location is in /Users/YOURSHORTUSERNAME/. 5) Drop the id_dsa file into this window.) 8) Now you need to authorize the public key for connection before you actually try to do so.

Alternately. because there is a last bit of housekeeping to take care of. This will leave the key in place but it will not be able to be used to log into your SSH account until it is authorized again. Click the (5) Manage Authorization link in the Public Key section of the screen. 3) Set up the rest of your SSH session as normal. you can authorize the public key for access to your account. Click the DOWNLOAD KEY button if you cPanel Guide 11. The public key needs to remain on the server if you want to use it to connect to your SSH account. then go back to the SSH Key management screen in cPanel. you can use the PuTTY Gen program in Windows to convert the standard OpenSSL key into the appropriate format. Do not share it with anyone or leave it in a public location. Once you are sure you have good local copy of your key.PPK version of the private key will be displayed. If you are sure.122 (C) 2012 Surpass Hosting . click the DELETE KEY button. You can click the DOWNLOAD KEY button to save the key to your computer (anywhere you want for now). Click BROWSE to select the private key you just downloaded and PuTTY will try to use that key to connect. If you want to temporarily disable access with the key pair. This should be your encryption (private) key password and not the password of your cPanel account.34 . Now you are ready to connect. Doing this will make sure that even if someone gains access to your cPanel account they will not get a copy of your private key. 2) When you start PuTTY. Now that you are ready. click the (5) Manage Authorization link again and click the DEAUTHORIZE button. Go back to cPanel. Regardless of which operating system you use or the program you use to connect. 4) You may want to save this session so you can use it as a shortcut to connect once the key is appropriately authorized. click the (4) View/Download link in the Public Key section. We suggest that you try to connect to your SSH account at this time using your new key. If you are able to log in. If you want to use the public key for other purposes or use it to authorize access somewhere else. you can can specify the key you want to use in the SSH Auth section of the interface. if you use the key to connect. you will be prompted to enter the password. make sure you have a good local backup of it and then click the (6) Delete link in the Private Key section. You need to make sure you keep your private key safe. you should delete the version of the private key that is currently stored on the server unless you plan to use the Java based SSHTerm in your browser to connect to your account via your key (more on that later). To remove the private key from the server. Click the AUTHORIZE button that appears. You will be asked if you really want to delete it.

To remove the key completely. SSHTerm is secure and will work for most needs. Don't forget to authorize the public key if you want to use it to connect. so make sure you are certain you want to do that. as there is generally no need to do that. You cannot use telnet to directly connect to an SSH cPanel Guide 11. so long as your web browser supports Java. The benefit to this app is that you may be able to use it in places that you normally would not be able to access a secure terminal. cPanel also provides a Java based Telnet terminal program.click the (4) View/Download link in the Public Key section. We do not recommend uploading your private key to our server. be sure to use the SSH client rather than Telnet because it is more secure. So long as your SFTP client knows where your private key is. Click the DOWNLOAD KEY button if you would like to save a copy of the public key locally to your device. click the (3) Delete link in the Public Key section and confirm the deletion by clicking the DELETE KEY button.34 . unencrypted version of the SSH protocol. On this screen. click the IMPORT button. You can use your cPanel account username and password to authenticate or your public/private key pair if you've saved both on our server and the key is authorized. you can manage your keys as normal. it can use that to authenticate. To connect to your account inside your web browser using a Java based SSH terminal. Whenever possible. but it is not as full-featured a terminal application as PuTTY or the terminal on Mac OS X/Linux/Unix. Just enter your cPanel username and your private key password. you enter the name for your key (if you don't enter one it will be called id_dsa) and then paste in your public and/or private keys into the appropriate boxes. you can do that by clicking on the (2) Import Key link. If you prefer to use a key you've already created elsewhere to authorize your SSH account.123 (C) 2012 Surpass Hosting . This will open a new window and download a small Java applet that will run in your browser to emulate a standard terminal. Telnet is basically an insecure. NOTE: In many SFTP clients you may also be able to use your SSH key to log into your FTP account. you may be able to use the Java-based SSH/Telnet clients that cPanel offers. If you are not in a location where you can use a local SSH/Terminal client to connect to your account. There are no more warnings. click on the CONNECT USING SSHTERM button (this will only appear if your account has SSH access enabled). Once done. If you don't want to upload the private key then just leave the private key box empty. Finally.

You cannot use telnet to directly connect to an SSH account and we do not directly support unencrypted telnet access to your account.34 .124 (C) 2012 Surpass Hosting . so we recommend you avoid this app and use the SSHTerm instead. cPanel Guide 11.unencrypted version of the SSH protocol.

125 (C) 2012 Surpass Hosting . This practice is known as "hotlinking" and it is a problem because when people do this. there are ways to deal with this. they cPanel Guide 11. Keeping your Account Secure: Hotlink Protection If you are having issues with people linking to your content without actually sending people to your site (your media content is loaded from your website but displayed on their website as if it is their content). they are not only stealing your content without your approval.Hotlink Protection Learn how to stop other people from directly linking to the content on your website.34 .

If you may any changes to the hotlink configuration. GIF. The most important setting for hotlink protection is the list of allowed URLs to access your media content. To stop this from happening. You can also control what sort of content receives hotlink protection. click the (1) ENABLE or DISABLE button. cPanel protects JPEG. parked or sub. enter the full URL (including http://) that you want to redirect to into the (5) text field provided for that purpose.e. This is most frequently the picture files on your site. NOTE: We do not recommend turning on hotlink protection unless you think you are likely to have cPanel Guide 11. addon. Add any other sites or domains that also should be allowed to directly request the media from your site. If there are problems. allow someone to directly load the media file in their web browser by entering the full path to that one item) by checking the box next to (4) Allow direct requests. You can choose to allow direct access to the protected media content (i. be sure to click the (6) SUBMIT button to apply the changes. but it is possible to block hotlink access to other sorts of media by their extensions. then try checking this box and see if that helps. so you foot the bill as well.domain. Also.com" need to both be listed separately. but you can add or remove whatever you want in the (3) block direct access box. By default. you should run tests on your site to make sure your media content is loading." To do that. but you can redirect their requests to a URL of your choice.34 . Any time you make a change and hotlinking is enabled. disable the protection and review your hotlink settings below to make sure they are correct. Each URL should be listed on a separate line in the (2) access box. If you are enabling hotlink protection.126 (C) 2012 Surpass Hosting . If you are having problems and you are sure your list of allowed URLs is correct. The items listed there should be the extension of the files you want to protect (the part of the file name after the period). cPanel automatically fills this box with all of the possible permutations of any main. So instead of them getting the JPEG of your latest master work. make sure you've correctly managed all of the settings and you should also run tests on your site to make sure that the hotlink protection isn't causing problems for you. "www. To enable or disable hotlink protection.com" and "domain..are using your bandwidth. PNG and BMP files. click on the HotLink Protection item on the cPanel home screen.domain. you can not only block the attempt of others to hotlink to your content. NOTE: For hotlink protection. they get a picture that says "do not hotlink. separated by commas with no spaces or periods.

127 (C) 2012 Surpass Hosting .NOTE: We do not recommend turning on hotlink protection unless you think you are likely to have problems with people stealing your content. cPanel Guide 11. Hotlink protection is an advanced security feature that can cause problems for you if you don't configure it properly.34 .

Stop People from Sharing Account Information to your Site Learn how to stop people from overusing the access details for password protected directories.34 .128 (C) 2012 Surpass Hosting . cPanel Guide 11.

That happens when a legitimate member of your site starts "sharing" their login information with other people so they can also access your content cPanel Guide 11.Password Sharing (Leech) Protection If your site has password protected areas that you use to restrict some content to paying members.34 . then "account sharing" may be a problem for you.129 (C) 2012 Surpass Hosting .

If you have not already enabled password protection. you can also have the server send you an e-mail to an address of your choice any time someone is detected going over the limit you set. If you need to.34 . They won't be able to log in because nothing they enter as a password will work. To set up leech protection. The first box asks you (1) how many times you want to allow an authorized user to log into your password protected area every 2 hours. so it is a good idea to enable the e-mail notification so you can contact the user or completely remove the account. If you want. The best choice is to a page explaining the issue and perhaps directing them to your signup page. Finally. all you have to do is answer a few questions and enable this feature on a directory that already has password protection enabled. Stopping the protection does not remove the authorized users or the password protection. cPanel offers a limited form of "leech" protection to prevent this sort of login sharing that only works with the Password Protection feature that cPanel offers. you need to enter the (2) special URL that you automatically send people to if their login goes over the 2 hour limit set above. This will restrict the account by removing the password from the password file. This value has to be a whole number and cannot be zero. as appropriate. but this page must exist somewhere outside of a password protected area or the user may not be able to see it. but remember that a single user may need to log in a few time if their browser or computer crashes. If you do set yourself to receive an e-mail but you don't disable the leechers account automatically. The system is not capable of restoring disabled accounts automatically. This URL can be any valid address anywhere on the web. You can also choose to have the server automatically disable the account by clicking the (4) Disable Compromised Accounts checkbox.130 (C) 2012 Surpass Hosting . You may be tempted to make this number quite small. it only stops the login tracking. though. you can reset that user's password there to allow them to once again access the protected content. If you want to prevent account sharing in cPanel password protected areas of your site. click the (5) ENABLE button to enable leech protection or (6) DISABLE to stop the protection. You will still see their account user listed in the Password Protection section of cPanel. they get disconnected from the Internet or otherwise leave your site and need to come back.without having to pay you additional money. Next. click on the Leech Protect item on the cPanel home screen. or if you want to review users or add new cPanel Guide 11. then you may get a lot of e-mails as you will get a new one every time that user logs in again.

131 (C) 2012 Surpass Hosting . click on the (7) MANAGE USERS button. This will take you directly to the Password Protection feature in cPanel.34 . or if you want to review users or add new ones. because FrontPage uses a proprietary method of securing content that is not compatible with the Apache standard method that cPanel uses. NOTE: As mentioned earlier. it will not work properly if you have Microsoft Frontpage server extensions installed in your account.If you have not already enabled password protection. cPanel Guide 11. this feature will only work if you use the Password Protection feature of cPanel. Thus.

but you or your company may require that sensitive e-mail messages be encrypted. This is fine for most people. PGP.132 (C) 2012 Surpass Hosting . It is plain text sent across the Internet with no encryption. PGP/GnuPG.34 . Encrypt Mail with GnuPG/PGP Keys E-mail is an inherently insecure method of communication.Mail Encryption with GnuPG Learn how to add and manage GnuPG keys to encrypt mail. cPanel supports the generation and storage of one of the more popular ways to encrypt mail. It works similarly to the SSH encryption keys discussed earlier in the cPanel Guide 11. which stands for Pretty Good Privacy is a key-based encryption system.

the time differential between the smallest and largest key sizes in actual use isn't really significant unless you have a slow computer). they won't have an unlimited amount of time to try to crack it. This is your private key. Generally though. The key does not "self-destruct" Mission Impossible style after the expiration date. cPanel does support the creation and storage of GnuPG keys on the server to make them easier to access when needed. it basically keeps communication safe.34 . To work with these sorts of keys. you keep to yourself and use it to encrypt and decrypt messages using the key and a secure password you've set. If you decide you want to let your key last forever. so there you do need to be patient. is a key you can freely give to anyone who may need to send you encrypted data or e-mail. You can import either public or private keys. The first section of this screen (1) Create a New Key allows you to do just that. One part. you can upload it to your account using the (5) IMPORT KEY button. you can view the whole key. Alternately. enter the timeframe as directed. The sender can use your public key to encrypt mail to send to you so that only you (with your private key and password) can decrypt the message and turn it back into text. GnuPG is a fully open-source implementation of the PGP standard. The larger the key size. the harder the key is to crack if someone gets a hold of the private key. The other half of the key pair. It may take several minutes. an optional key comment or nickname and a secure password (entered twice). click the GuPG Keys item on the cPanel home screen. it is possible to create a PGP-style key that works with several e-mail accounts. it is best to generate separate keys for separate e-mail accounts). Since brute force methods to crack a large key could take many years. You enter the name to be associated with this key. the e-mail address that this key will work with (although cPanel does not support it. Theoretically. one at a time. don't enter anything in the (2) Expire Date box. This forced expiry makes sure that even if someone does get a hold of your private key. if you already have a key you've generated elsewhere.133 (C) 2012 Surpass Hosting . It is generally recommended that you set your key to expire after a certain period of time (1 year is usually a good idea). click the (4) GENERATE KEY button to have the system create the key for you. The (3) key size is also important. for security. Finally. but generally. You create a key in two parts.SSH section of this guide. no one can read the content of the encrypted message but you. but the key won't be valid for use any longer. This requires additional software on both the sender and recipient's end. However. Otherwise. but you can choose up to 4096 if you want. cPanel Guide 11. 1024 is the typical value for a key. cPanel does not directly support key-based encryption of mail. Just paste the text key data into the box presented and click IMPORT. the key details or choose to delete the key. If you have some keys stored in your account. the public key. but the longer the key takes to be created or to be used (the larger the key the more time the server will take to generate it.

visit the GNU Privacy Handbook or the PGP Wikipedia page.If you'd like to learn more about PGP/GnuPG or public key encryption schemes.34 .134 (C) 2012 Surpass Hosting . cPanel Guide 11.

Managing your Domains cPanel Guide 11.135 (C) 2012 Surpass Hosting .34 .

thisismydomain555.34 .COM" and then set up a FTP account that has the kate subdomain directory as its home." This is great if you want to create an easy to remember "separate" section of your main website.YOURDOMAINNAME.COM. cPanel Guide 11. For example.YOURDOMAIN. if your domain is "thisismydomain555. That user can then use FTP to upload their website (or install a script) and then their subdomain "kate" would look completely different than your main domain." For example. remove and change subdomains in cPanel. if you install a calendar script.com" a subdomain would be "pictures.thisismydomain555. Subdomains cPanel allows you to create what are known as subdomains. Subdomains are "something.com. you could use a subdomain like "calendar. You would create the subdomain "kate.YOURDOMAIN.COM" You could also set up individual websites for family or friends using subdomains.com" or "blog.136 (C) 2012 Surpass Hosting .Subdomains Learn how to add.

however. There you will see a table of your subdomains and their current settings and available actions. choose one of the domains or subdomains in your account from the (1) drop-down list (yes.domain.To set up a subdomain.com. you could have a subdomain like charles. if you want the subdomain to feel more "separated" from the main domain. in some cases it may take a bit longer (sometimes up to an hour) for the new subdomain to start working. If you do that.mydomain. delete the suggestion and type the name you want to use as the document root (home) for this subdomain. then the subdomain sub. you can see that there are two different subdomains created.com whose home directory is /home/domain/public_html/test and is available via domain. click the (4) CREATE button to create the new subdomain.domain. First you see the (5) full subdomain name. without the public_html. A redirect will cause anyone who goes to that subdomain (like sub. but for some people their local DNS servers may not pick up this new subdomain entry for a bit. site2. To create a subdomain. it is possible to create subdomains of subdomains.com/test (as well as test.137 (C) 2012 Surpass Hosting .com/site2 and another one called test. So if you change it you will need to manually move/remove files from the old location.domain.domain. Next. NOTE: Subdomains you create are usually accessible in your web browser immediately after you create them.domain. You can click on the document root itself to go to the cPanel File Manager to add/delete/upload files right from your browser) or you can click the small pencil and paper icon next to it and you can change the document root for the subdomain if you want.domain.com which has its home in /home/domain/site2/ and is not accessible via domain.domain. if you domain name is domain. You can make changes to your subdomains in the Modify a Subdomain section. click on the Subdomains feature in the Domains section of the cPanel home screen. then sub.com/sub will both go to the same content. cPanel will automatically fill in the (3) Document Root with a suggested value which is a directory of the same name inside the web root for your main domain (public_html). anywhere on the Internet.com and domain. Note that changing the document root does not move or remove the existing subdomain directory. However. you can see any (7) subdomain redirection you've set up.com that automatically redirects people to Charles' real website that he hosts elsewhere. The subdomain is set up right away. By default cPanel Guide 11. it just creates or sets a new location.34 .com/sub (since the home directory for the domain is now "above" your main domain's home directory of public_html.my.is.com) to be automatically and instantly redirected to some other location. When you are done setting up your new subdomain. so for example. For example. Then comes the (6) document root (subdomain home directory). you could create this. one.com which is 3 subdomains deep) then you type in the (2) subdomain name (the part at the front of the domain name before the first period. Whatever you type in there.com will NOT be accessible from domain.com). If you accept this value. If you look at the bottom of the screen shot above.

NOTE: If you have an addon domain pointed to a subdomain. cPanel will not permit you to remove the subdomain. Just remember that these people will not have access to cPanel and the full feature set that provides and they will be using your plan's disk space. Then give the person you've set up this subdomain the FTP account username and password you just set up and they can manage their website. cPanel Guide 11. If you want to use a subdomain like a mini web hosting account for friends or family. you can go to the FTP Accounts feature and set up a FTP account that uses the subdomain's document root (home directory).34 . You do this by clicking on (9) Remove and then confirming the removal. click on the (8) Manage Redirection link and enter the URL you want people to be redirected to automatically when they visit this subdomain. If they have serious needs. bandwidth and other resources. If you have a lot of subdomains. By default there is no redirect. you must remove or move the addon or parked domain that is pointing to that subdomain first. click the button to remove it. we suggest you refer them to us for a full hosting account or you can upgrade your account to a reseller plan and handle it yourself. Note that this does not delete the home directory for this subdomain or the files located in that directory.138 (C) 2012 Surpass Hosting . you can search through them quickly by typing all or part of the subdomain into the (10) Search box and clicking GO.that automatically redirects people to Charles' real website that he hosts elsewhere. If you want to also remove those files you will need to do so manually. This will display only the subdomains that match what you've entered. The URL can be any valid address anywhere on the Internet. but if you want one or if you want to remove an existing redirect. If you want to remove it. Finally you can delete the subdomain completely. You can also set up e-mail addresses or e-mail forwarders for subdomains. so they can even have custom e-mail accounts to use with their subdomain. If you want to remove the redirect. but people will no longer be redirected when visiting it. The subdomain will remain in place.

If this is permitted. Addon Domains On some of the plans we offer.Addon Domains Learn how to add additional domains to your cPanel account (if supported by your web hosting plan).139 (C) 2012 Surpass Hosting .34 . you may be permitted to host more than one domain in your cPanel account. click on Addon Domains on the cPanel home screen to add another domain to your cPanel account. cPanel Guide 11.

You can change the suggested values to whatever you want. Next. you can create your addon domain by filling in some basic information. Things you need to do before you add the domain: Before you can add on a domain to your cPanel hosting account. cPanel will automatically set up "www. On the Addon Domains screen in cPanel.com. please contact us to discuss a hosting plan that does allow you to host multiple domains. Finally.140 (C) 2012 Surpass Hosting . The (2) Subdomain/FTP Username field lets you enter a short name without spaces or non-URL-safe special characters that will be both the FTP account username (the FTP username will be whatever you type here plus "@YOURMAINDOMAIN.org.COM (the domain you've registered). When you enter the domain name do not enter "www. then you should look into our reseller shared hosting. etc. cpanel will automatically fill in the next two fields with suggested values based on the domain name you've entered. . NOTE: It is not possible to create another cPanel hosting account just for the addon domain). Also. then you are ready to proceed. Your domain name is just YOURDOMAINNAME.COM is your main cPanel domain). If you are unsure how to do this. Once you've entered the domain name. the username cPanel will suggest is the main part of your addon domain name without the TLD/SLD (. If you are looking to create multiple cPanel accounts for multiple domains. please contact your registrar for assistance. addon domains are a special sort of subdomain of your main cPanel hosted domain. or leave them as-is.Addon domains can appear to be completely separate content to visitors. you will need to register the domain you want to add onto your account (you must do this before trying to add it).) Feel free to change it if you want to use something else.net. The same goes for bandwidth and other features. The name you type in this field will also be the name of the subdomain that is created in your main domain. you must point your new addon domain name to the same nameservers that your main cPanel hosted domain is using. By default. You can register the domain through us or through another registrar if you wish. capitalization in the domain name itself does not matter and will be ignored by cPanel. This is done by logging into your registrar and updating the nameserver records for the domain to those we gave you when we first set up your hosting account. All of this is managed from one cPanel account. Once you have the domain registered and using our nameservers." that is not part of the domain name. Those plans allow you to use a tool called WHM to create and host multiple domains with multiple cPanel hosting accounts. make sure your plan allows for at least 1 addon domain. cPanel Guide 11. That means your addon domains share the total amount of disk space you are allowed to use with your main domain. . First." when it creates your addon domain. If not.34 . you need to enter the domain name you want to add to your account by entering it in the (1) New Domain Name field.COM" where YOURMAINDOMAIN. Addon domains share the features and resource limits of your cPanel hosting account. but in reality.

Plus with our reseller plans you can.com) but also be accessible as a directory of your main domain (http://domain.domain.com. The last step before creating your domain name is to enter a (4) secure password. so please be patient.com/addondomain. You may not want this because it makes it easier for people to figure out your addon domain isn't really hosted separately from the main domain. they remain completely separate. you may stop this process and cause problems that our support department may need to fix for you before you can attempt to add on the domain again. If you don't place your addon domain inside public_html. If you do. cPanel is not only creating a new subdomain and FTP account.COM. if you wish. If the process finishes and cPanel displays an error.com/addondirectory so it makes it that much less obvious.net. this allows you to create separate cPanel accounts for each domain you wish to host.without the TLD/SLD (. The (3) Document Root field will be where the content for your addon domain is served from. this screen will show you the details for your addon cPanel Guide 11.com/). then users who figure it out would still be able to access your domain at addon. two times.domain. Click the (5) ADD DOMAIN button to have cPanel start creating your addon domain. That way.com. That would be /home/YOURCPANELUSERNAME/ADDONDOMAINDIRECTORY. but keep in mind that it cannot match the name of an existing subdomain or FTP account. This will place the addon domain within the web root for your main domain. etc. By default. NOTE: The process of adding domains to your account is very complex.) Feel free to change it if you want to use something else. so the addon domain would not only act like a subdomain (http://addon.141 (C) 2012 Surpass Hosting . perhaps more than paying for the cost of your reseller hosting plan. cPanel will suggest /home/YOURCPANELUSERNAME/public_html/ADDONDOMAINNAME. it is adding your addon domain details to your cPanel account and to the web server. please make a note of exactly what cPanel said the problem was and then go back and correct it (if you understand the issue) or contact our support department for assistance. . Contact our sales department if you are interested in a reseller hosting plan. As discussed earlier. You can use the Password Generator feature to automatically create a secure password if you want.org. NOTE: If you don't like the way addon domains work (as special subdomains of your main cPanel domain) then you may want one of our reseller hosting plans. but they would not be able to access it as http://domain. Once you have at least on addon domain. choose to sell cPanel hosting to other people. You can choose to make the document root for your addon domain appear in the home directory of your main domain (outside the web root). . This process can take time. DO NOT click the ADD DOMAIN button multiple times or close or navigate away from this page until cPanel tells you the process is complete.34 .

as well as the subdomain used by this addon domain and also get rid of the FTP account for this domain. cPanel will attempt to delete the addon domain itself. If you have problems with the removal and cannot figure out the issue. you may find it useful to use the (12) Search feature. If you have many addon domains.142 (C) 2012 Surpass Hosting .34 . You can choose to set up (10) redirection. any (9) redirect you may have set up. the current (7) document root of the addon domain (you can also click the small pencil and paper icon to change the document root of the addon domain if you wish). including the (6) full addon domain name. cPanel Guide 11. please contact support for assistance. you will be told and you can try to delete the subdomain and FTP accounts separately if you wish.Once you have at least on addon domain. this screen will show you the details for your addon domain. and a set of actions you can take concerning your addon domain. If there are problems removing any of these things. Type in at least part of the domain you are looking for and cPanel will show you all of the addon domains that match what you've typed. If you choose to remove the addon domain. the (8) subdomain/FTP username. which will automatically send people visiting your addon domain to some other location (either in your account or somewhere else on the Internet) or you can (11) remove the addon domain.

The parked domain name will stay in your web browser's address bar in some cases. because that is the way the links are formatted. then you can also add additional domain names that all mirror the content in your main domain. Parked domains are not designed to be separate domains with discreet content (like addon domains).34 .143 (C) 2012 Surpass Hosting . The parked domain takes you to exactly the same content as your main domain. but many scripts. Working with Parked Domains If your hosting plan allows you to host multiple domains in your account. cPanel Guide 11.Parked Domains Learn how to add or remove parked domains if your web hosting account supports it. Click on the Parked Domains item in on the cPanel home screen to get started. redirects and HTML pages with absolute links may change the URL back to your main domain. Adding a parked domain is much simpler than adding an addon domain.

Type part of the domain you are looking for into the box and click GO and cPanel will display only those parked domains that at least partially match what you've entered. You can register the domain through us or through another registrar if you wish. you will need to register the domain you want to park on your account (you must do this before trying to add it). NOTE: All parked domains are set to mirror your main domain's content. make sure your plan allows for at least 1 parked domain (if your plan allows you to host multiple domains. Next. If you are unsure how to do this. Once you have at least one parked domain. you probably already have access to this feature. Finally.Things you need to do before you park the domain: Before you can park a domain to your cPanel hosting account. you can use the (7) Search field to quickly find what you are looking for. cPanel Guide 11. You can choose to (5) remove the parked domain so it no longer is part of your account and you can (6) Manage Redirection if you want to have people visiting your parked domain name automatically redirected to some other location. then you are ready to proceed. If you get an error.34 .144 (C) 2012 Surpass Hosting . It will take cPanel a few moments to finish working. (4) any redirects you've set up and finally a set of actions related to this parked domain. To park a registered domain that is already using our nameservers. You cannot park a domain on top of an addon domain at this time. please contact us to discuss a hosting plan that does allow you to host multiple domains. If not. you will find it listed at the bottom of this screen. please type the domain name (without www. either in your account or somewhere else on the Internet. go back and fix the problem and then try to park the domain again. Finally. Once you have the domain registered and using our nameservers. please contact your registrar for assistance.) into the (1) add domain field and click the ADD DOMAIN button. make a note of the exact error message you received and contact support for further assistance. the (3) parked domain root directory (public_html). you must point your new parked domain name to the same nameservers that your main cPanel hosted domain is using. so please be patient and do not close or navigate away from this page until cPanel confirms that it is finished. if you have a lot of parked domains. This is done by logging into your registrar and updating the nameserver records for the domain to those we gave you when we first set up your hosting account. If you are unsure what to do. From there you can see the (2) parked domain name.

cPanel Guide 11.Domain Redirection Learn how to use cPanel to redirect traffic from one place to another.145 (C) 2012 Surpass Hosting .34 . if a street is under construction. The same thing is possible with web traffic. Redirecting Traffic When you are driving. you may be temporarily or permanently directed to take another route to get where you are going. To set up this feature click on the Redirects item on the cPanel home screen.

choose temporary. One final decision to make before creating your redirect is to decide whether you want the redirect to pass along the file you are trying to access to the redirected location. You can choose any one addon or parked domain or subdomain or you can choose to have the redirect apply to all domains and subdomains in your cPanel account (all public domains).com/ (without the file. A temporary redirect causes Apache to send a code 302 with the redirect request.34 .php). Once you've made your choices.com/file. For example. Users won't notice any difference between a temporary or permanent redirect and both redirects act exactly the same in a browser. This URL can be any valid URL. press the (7) ADD button to create the redirect. If the wildcard redirect is off. this will affect search engine results. However. if the wildcard redirect is enabled and the redirect is from http://domain.com/ to http://otherdomain. If you want the redirect to apply to the main domain or subdomain you've chosen.146 (C) 2012 Surpass Hosting .php" (http://domain. A redirect does just what it says.php will be redirected to http://otherdomain.com/ and the user is trying to access a file called "file. The type of redirect you choose actually sends a different code number as it asks for the redirect. but it may be again in the future. type it in the (3) field next to the domain selection drop-down list. Then you need to enter (4) the full URL to the location you want to have people redirected to.php) the wildcard redirect would send the user to http://otherdomain. This tells search engines to stop listing this particular link in their search results and instead list the location that you are redirecting to. The search engine will continue to list the location in their search results and will periodically recheck the link to see if the redirect has been removed and content restored. Then select the (2) domain or subdomain you want this redirect to apply within. NOTE: The wildcard redirect feature cannot be used to redirect people from the main domain in your cPanel account to a file in a subdirectory elsewhere in your site.From here.php. they will immediately be sent to the alternate location you specify. Enabling this is called a (6) "wildcard" redirect. where the choice of a temporary or permanent redirect matters is when search engines explore your site. if you don't ever expect to have real content in this location. leave this field empty. choose permanent. Now you need to decide if you want your redirect to also apply to users who type "www. if a user visits the location you have set up a redirect for. If the redirect is permanent (the content in the existing location will never return) then Apache sends a code 301 redirect. so if you only expect the redirect to last a short time. Good search engines should eventually stop listing the redirected URL in their results.com/file." in addition to your domain name or not. To create a redirect. If you want this redirect to apply only to a subdirectory in the domain(s) you've selected. you can set up temporary or permanent redirects for your site. then http://domain. cPanel Guide 11.com/file. Choose the correct (5) radio button next to the choice you want to select. first select the (1) type of redirect you want. This tells the search engine that the content at this link is currently not available. Remember.

if the redirect applies to (12) URLs with "www. you may find it easier to use the (15) Search field.34 . You will be asked to confirm your choice. if you have a lot of redirects set up. You can see the (8) domain the redirect applies to. it will be listed in the Current Redirects section of this screen. you can click the (14) X icon to delete the listed redirect if you no longer want it. Also. the (11) type of redirect (either permanent or temporary).147 (C) 2012 Surpass Hosting . the (13) wildcard status of the redirect and finally. cPanel Guide 11." entered or not. the (9) directory (if any) that this redirect is active in. the (10) URL that people are being redirected to. Type in some part of the redirect you are looking for and click the GO button and cPanel will display only those redirects that match at least partly what you've typed.Once you've created at least one redirect.

148 (C) 2012 Surpass Hosting . DNS Zone A and CNAME Records The feature described here is very advanced.Simple DNS Zone Changes Learn to add or edit certain basic record types to the DNS zone(s) for your domain(s).34 . cPanel Guide 11. Don't attempt to use this if you aren't aware of the ramifications. please contact support for assistance and we can make the needed changes for you. Making the wrong addition or change may adversely affect the loading of some or all parts of your website. If you are uncertain.

To add a new A record. To add a new CNAME record. enter the (4) name in your domain that you want to have alias some other name or location. The records you add with this tool will appear in the User-Defined Records section of this screen. When you are ready. you may be able to access the changed record you've entered almost immediately. but it could take up to 24-48 hours to be picked up by your local DNS servers. The (5) CNAME record location you enter.com but not for location. DNS entry information can take time to propagate. then you can create an A record for location. A DNS zone file contains critical information about your domain and where to find various parts of it. Check your entry and try again. If you need an existing A or CNAME record changed. if you are managing DNS at your domain registrar). you can see all of the details of the records you've added and also (7) delete them if you cPanel Guide 11. you enter the (2) IP address that you want the name you just entered to point to. This name must be in one of the domains managed by your cPanel account. NOTE: Although cPanel will add the appropriate record to your domain's DNS zone almost right away. The CNAME is where the record in your domain will be aliased to. With the Simple DNS Zone Editor feature you can add or edit additional A and CNAME records. you will see an error. check your entry and try again.mydomain1. Therefore. enter the (1) name of the record you want to add in the Add an A Record section of this screen. NOTE: This feature does not let you edit existing A or CNAME records created automatically by cPanel. change or delete additional records with this tool.com managed in your cPanel account.com.mydomain3. if you have mydomain1. Next. cPanel will warn you if it detects a problem with the record you've entered. This is due to the way the DNS system works and not due to any issues with cPanel or this feature. Click (6) ADD CNAME RECORD when you are ready to commit this new record.com and mydomain2.mydomain2. An A record points part of your domain to a particular IP address. For example. you can only add. click the (3) ADD A RECORD button. cPanel will add the record and reload the DNS zone on your server. Here.com or sub.cPanel does allow you to make additions to the DNS zone for the domains and subdomains hosted in your cPanel account. please contact support for assistance. however. If so. this feature will not work if you are not using cPanel to manage your DNS settings (for example. could be in any valid domain anywhere on the Internet.34 . it doesn't have to be the IP address assigned to your cPanel account. If you've entered information that appears to be correct. A CNAME record serves to alias one name to another.149 (C) 2012 Surpass Hosting . The IP address can be any valid address. Also. To use this feature select the Simple DNS Zone Editor from the cPanel home screen. The name must include a domain name hosted in your cPanel account. If not.

Here, you can see all of the details of the records you've added and also (7) delete them if you
choose.
NOTE: If you are looking to change your MX (mail) record, please see the MX Record section of
cPanel.

cPanel Guide 11.34 - 150

(C) 2012 Surpass Hosting

Databases

cPanel Guide 11.34 - 151

(C) 2012 Surpass Hosting

Working with MySQL Databases
Learn how to manage MySQL databases in cPanel.

cPanel Guide 11.34 - 152

(C) 2012 Surpass Hosting

34 . Databases are commonly used by popular web scripts in order to store the content of the site (text and settings cPanel Guide 11.153 (C) 2012 Surpass Hosting . A database is tool that allows you to collect all sorts of data in one place and then work with that data in various ways.The Main MySQL Databases Screen Your hosting account provides access to MySQL databases.

and sometimes files) separately from the design/code of the site.
NOTE: If you are looking for a quick way to create a new database and user for a script you are
trying to install, you may find it easier to use the MySQL Database Wizard feature in cPanel. Skip
down to the next item in this guide to learn more about how it works.
cPanel allows you to easily create, manage and remove MySQL databases. Click on MySQL
Databases from the cPanel home screen to access this feature.
To create a new database, all you need to do is to enter the name you want to give it into the (1)
New Database text field then click the (2) CREATE DATABASE button.
NOTE: Your cPanel username and an underscore character (_) will automatically be prefixed to
the database name you enter. So if you enter "data" then the full database name will be
"CPANELUSERNAME_data" where CPANELUSERNAME is your account's cPanel user name.
Also, database names can only contain certain characters, may not be over a certain length and
must be unique. cPanel will stop you from trying to create a database with a name that will not be
valid.
Databases you have created will appear in the Current Databases section of this screen. You will
see the (5) full database name, the (6) current size of the database (the size information is cached
by cPanel and so the size information will only update every few hours or so), the (7) names of any
users assigned to the database (click on the name to change the user's permissions for this
database or click the red X to remove that user from this database without deleting the user), and
finally, you will be able to (8) delete the database itself. If you have a lot of databases, you can
quickly search for the one you are looking for by using the (17) Search text field. Enter part of the
database name you are looking for and click the (18) GO button. cPanel will only display those
databases that match what you've entered.
NOTE: If you delete a database, any users assigned to it will not be deleted, but all of the data in
that database will be permanently deleted unless you have a backup. Also, you will likely see a
database that matches your cPanel username that you cannot edit or delete. This is a database
that stores important information about your MySQL databases and it is automatically handled by
MySQL and cPanel. You should not attempt to delete the database.
When you create a database, it will start off without any structure or data in it and no one is allowed
to access the database. If you want to be able to add data to the database or set up a script to do
so, you will want to add a MySQL user to allow access to the database. Just like you need a
username and password to access your cPanel account, you also need a MySQL user and
password to be able to work within a particular database. A single MySQL user can have access to
cPanel Guide 11.34 - 154

(C) 2012 Surpass Hosting

password to be able to work within a particular database. A single MySQL user can have access to
multiple databases and can have different sets of permissions concerning what they are allowed
to do inside the database.
To create a MySQL user, enter the last part of the name into the (9) Username text field. Like the
database name, your cPanel username and an underscore character will be automatically
prefixed to the username you enter, so keep that in mind. Enter a password for this MySQL user
two times in the (10) Password fields or use the Password Generator feature, then click (11)
CREATE USER.
The final step is to add the user you just created to a database and set the permissions that you
want to allow that user to have in that database. To do that select the (12) user and the (13)
Database to add them to and then click the (14) ADD button. This will open a new screen, where
you can select the sort of commands/queries they are allowed to run on the database. If you are
creating this database for use with a script, then it is best to check the All Privileges check box, so
all of the listed items are enabled for that user. Alternately, just select the individual permissions
you want that user to have in the database. Finally, click the MAKE CHANGES button to complete
this process. Now that user should be able access the database and do the things you've granted
them access to.
NOTE: A single MySQL user can be granted access to multiple databases, but we discourage that
practice because it is insecure (especially if you've enabled remote MySQL access).
All of the users you've created will be listed in the Current Users section of this screen. It will
display the (15) username of each user and allow you to (16) delete that user. Click on the
username to be taken to a screen where you can change that user's password.
NOTE: Deleting a user removes the user only. It does not delete any data or databases that the
user had access to. So if you accidentally delete a user, you can recreate the user with the same
password and re-add it to the appropriate databases and everything should be OK. If you change
a MySQL user's password and that user is one that a script is assigned, you will need to go into the
script configuration file and make sure the MySQL user password is changed to the new one. If
you don't do that, the script will be unable to access the database.

cPanel Guide 11.34 - 155

(C) 2012 Surpass Hosting

MySQL Database Creation Wizard

If you just want to quickly create a MySQL database and user so you can start working, or if you're
afraid you might miss a step in the standard MySQL management screen, then you will want to use
the MySQL Database Wizard feature found on the cPanel home screen.
The wizard walks you through creating a database, then creating a MySQL user for that database
and assigning permissions to that user. When done, you the database will be fully ready for use
(for example, by a web script you've installed in your hosting account.
The interface for doing all of this matches what was discussed above in the main cPanel MySQL
Databases section, so if you want to understand how all of that works, please read about those
features above.
NOTE: If you need to add extra MySQL users to a database or if you want to use an existing user in
a new database, then you will need to use the MySQL Databases item in cPanel to do that. The
wizard only covers creating a new database and assigning a new user to it.

cPanel Guide 11.34 - 156

(C) 2012 Surpass Hosting

net/home_page/docs.php NOTE: The version that cPanel offers is specially modified to maintain account/database security cPanel Guide 11. phpMyAdmin is a complex program that can do very powerful things.phpmyadmin. you cannot actually work with the data inside the databases.PHPMyAdmin Learn how to use PHPMyAdmin to handle advanced MySQL database tasks. Databases: PHPMyAdmin Although you can easily create and delete databases and users in the main MySQL Databases feature in cPanel. Therefore. click on the phpMyAdmin item on the cPanel home screen. To start working with it. It is basically a graphical front-end to the MySQL database service.34 . However. then we suggest you review the resources available here: http://www. explaining how phpMyAdmin works is beyond the scope of this guide. If you need assistance working with phpMyAdmin. It is called phpMyAdmin.157 (C) 2012 Surpass Hosting . cPanel includes a specially configured piece of third party software so you can do just that.

You should create/remove MySQL databases or users via the MySQL Databases feature in cPanel. we suggest that you avoid using phpMyAdmin because it is possible to destroy or alter data permanently if you do something wrong. not in phpMyAdmin. If you aren't familiar with phpMyAdmin or MySQL queries. you will not be able to create databases using phpMyAdmin.and it does not offer all of the features you typically find in phpMyAdmin. If there is a feature you are looking for and it doesn't work as expected or is disabled. For example. it is for security reasons/compatibility with cPanel.34 . cPanel Guide 11.158 (C) 2012 Surpass Hosting .

we strongly recommend against using wildcards to allow access to your databases. make sure all of your MySQL user passwords are long. so only enable it if you are absolutely sure you need it and _never_ enable it for all IP addresses. To do this you enter the IP address in the (1) Host field and then click the (2) ADD HOST button. You can add your IP address again later if you need remote access again.% would allow anyone on the IP addresses 192. MySQL databases you create can only be accessed by local processes or users.1.255 to access your MySQL databases remotely. but you can. hard to guess and very secure.34 .0 through 192. the access host 192.159 (C) 2012 Surpass Hosting .168. All changes you make on this screen take effect immediately. you have to tell MySQL which IP address(es) to allow.168. if you wish. For example. access your own MySQL databases remotely (perhaps to work on them using some special application like Navicat MySQL).Enabling Remote MySQL Access Learn how to enable or remove remote access to your MySQL databases.1. NOTE: Enabling remote MySQL access for your databases can be a serious security risk.1. PLEASE BE CAREFUL! For security reasons. cPanel Guide 11. It would be best to enable remote access for your specific IP address only when you need it and then remove the access host when you are done working.168. NOTE: You can use the % character as a wild card. To enable remote MySQL database access. Databases: Managing your MySQL Databases Remotely By default. Further. in the screenshot above.

you can see all of the ones you've added in the (3) Access Hosts list and then choose to (4) remove the access host so it can no longer access your databases.34 .Once you've added an access host. cPanel Guide 11.160 (C) 2012 Surpass Hosting .

34 .Software and Services cPanel Guide 11.161 (C) 2012 Surpass Hosting .

NOTE: You may have access to an item called "Simple CGI Wrapper. add. timers and other tools. For example. you can view. click on the CGI Scripts item on the cPanel home screen. Click on the item(s) you are interested in and follow the directions presented to configure them. cPanel offers a few Common Gateway Interface (CGI) scripts that may help you enhance your site with web to e-mail form generators. clocks. you do not need to use this item and should not install it.34 ." If so. Working with Software and Services: CGI Scripts In cPanel's Software and Services section.162 (C) 2012 Surpass Hosting .CGI Software Learn how to add and configure some simple CGI scripts for use on your website. cPanel Guide 11. To access this area. We run CGI scripts as suexec automatically (meaning that the CGI script runs as your cPanel user rather than the user "nobody") which is exactly what this feature was designed to do (to add support for that feature on hosts that don't already support it). change and remove various addon features that can help enhance your website.

Add/Remove Software
Learn how to use cPanel to add and remove some software from your account.

Installing and Removing Some Site Software

cPanel has the ability to install some web scripts that you can use to enhance your website.
However, we offer other web script installation options and we encourage you to use them instead
of this feature. However, if you want to investigate the few options you may have available to you
here, click on the Site Software item on the cPanel home screen.
From there, you can select one of a few popular web scripts to install. You will be able to read
more about the script and what it does and answer a few simple questions and cPanel will
cPanel Guide 11.34 - 163

(C) 2012 Surpass Hosting

automatically install the web script and a database if needed. cPanel will also be able to upgrade
scripts that it has installed (but not ones that you install manually or via other web script installers)
and it can remove scripts that it has installed.
NOTE: Do not worry if you don't see a lot of software available here, because as we stated, we
offer other web script auto-installation options that update more frequently and offer more options
than those that cPanel offers itself. Please read on to learn more about the other web script
auto-installer features we offer.

cPanel Guide 11.34 - 164

(C) 2012 Surpass Hosting

Perl Modules
Learn how to view the list of installed Perl modules.

View Perl Modules

One of the programming languages that our web hosting accounts support is Perl. Perl is modular
and extensible. This means that new features can be added through Perl modules. This allows
Perl to gain new features as needed and yet not have to ship with every possible feature built into
the core of the language. cPanel itself is written largely in Perl. Because of this every cPanel
server has lots of addition Perl modules installed that extend what you can do with Perl in your
own scripts. To see what perl modules are available on your server, you can click on the Perl
Modules feature on the cPanel home screen.
On this screen you will see a list of modules and in some cases be able to see documentation
related to the use of that module. If for some reason you don't see the Perl module you need to get
cPanel Guide 11.34 - 165

(C) 2012 Surpass Hosting

8. it specifically requires Perl version 5.166 (C) 2012 Surpass Hosting . cPanel Guide 11. Our technicians will review your request and if the module in question won't cause problems for the server or other clients we may choose to install it for you so you can use it. it may not operate properly on our servers.your own Perl script working. Changing the installed version of Perl would break cPanel. NOTE: Since cPanel itself is written largely in Perl. There is nothing we can do about this.8 and if you have a Perl script that requires a much older or newer version of Perl. please contact technical support and let us know what you need.34 .

NOTE: Because PHP/PEAR/PECL modules take more time and resources to install and use. PHP is a very popular language on the web.34 . From this screen. click on the PHP PEAR Packages item on the cPanel home screen. A lot of notable web-based software is written in PHP. If you would like to see what is available on your server. you can view all of the installed modules in PHP and view documentation (geared towards developers). PHP Settings PHP has several settings that may affect the way your PHP-based scripts will run. PHP Modules Another popular programming language that we support in our web hosting accounts is PHP. we generally limit all clients to those modules that are already installed on the server. PHP still has a number of optional modules that can be added to it. You can view those settings by clicking on the PHP Configuration item on the cPanel home screen. cPanel Guide 11.167 (C) 2012 Surpass Hosting .PHP Modules and Settings Learn how to view the list of installed PHP (PEAR/PECL) modules. Although PHP is not as modular as Perl is designed to be.

htaccess file (create it if it doesn't exist already in the location where you want this change to take effect): AddHandler application/x-httpd-php5 .9 (5. cPanel Guide 11.9 is available for very old scripts that aren't compatible with PHP 5). while those ending in .php . Also. if you need to make changes to the PHP settings listed on this screen. PHP 4 was discontinued a long time ago and PHP 5 is the only officially supported version (by PHP.34 . Also we do currently support PHP 5 and PHP 4 on most of our servers.htaccess file. please contact technical support for assistance and we can make the changes for you.php .2. cPanel then adds the appropriate line to the . To make PHP 5 the default.php5 If you prefer to use PHP 4. If you need some PHP settings changed. then you may be able to select which version of PHP you want to use as the default for your cPanel account. add the following to the .ini file. If your server does support both.php are parsed with PHP 5. files ending in . PHP settings changes must be added to a custom php.htaccess file instead: AddHandler application/x-httpd-php4 . Be aware that there are some settings we will not change for security reasons or in order to maintain a good hosting environment for everyone.htaccess file if you wish.4. most of our servers currently support both PHP 5.2.On this screen you will see a list of the settings that most frequently affect the operation of PHP scripts.htaccess file in your public_html directory (essentially changing the default for all of your web content.x and 4.168 (C) 2012 Surpass Hosting . Also. then place the following in the . we reserve the right to discontinue PHP 4 support at any time (though we will post notices before doing so).net). though you can manually set other options in other directories via the .x is the default and 4.php4 NOTE: By default.php4 are automatically parsed with PHP 5 and those ending with . you cannot do so in your .4.php5 are parsed with PHP 5.

34 . Fantastico Web Script Autoinstaller We are in the middle of migrating to Softaculous to handle web-based software installation. Softaculous or both. if you're not comfortable installing a web script yourself. we offer Fantastico De Luxe.169 (C) 2012 Surpass Hosting . However.Fantastico Learn how to use Fantastico to install popular web software into your account. There is a lot of great software out there that you can use on your website. Answer a few simple questions and in a few clicks you have software cPanel Guide 11. It handles all of the "heavy lifting" for you. so your cPanel account may have Fantastico.

The final screen may take a few seconds to load fully. Once you've entered the required details. Periodically scripts will get updated in Fantastico.com/directory/).installed on your website.domain. you should now see the (4) location of your newly installed script. and when that happens and you visit Fantastico. click on the Fantastico item on the cPanel home screen. click the button to start the installation process. cPanel Guide 11.com/directory/) or a subdirectory of a subdomain (http://sub. you will be taken to a screen showing the installation details where you can confirm if you want to delete the script. Fantastico will check to see if there are any issues with installing the script in the location you've chosen and if it detects a problem. a subdirectory of the main domain (http://domain. the script and all related data will be deleted and a confirmation will be shown. The next screen will confirm where everything is being installed and you will click one more time to actually finish the installation. NOTE: Fantastico can only update scripts that it has installed.com). Click the upgrade link to start the process. If you click the REMOVE button. you will see links to the URLs where you can access the public side of the script (for regular users/visitors) and also the administrative login location. Back on the script installation screen.34 . so please be patient. a link to visit the (5) installed script location and another link to (6) remove the script. Once done.com/). ready for use! To get started.170 (C) 2012 Surpass Hosting . it will tell you what it is so you can take action manually. Fantastico will warn you that upgrading may remove any code-level changes you've made (because all script files are physically replaced with updated ones) and Fantastico will prompt you and create a set of backups that can be manually restored if something goes wrong with the upgrade and then complete the upgrade.com/directory. Fantastico only allows for one script installation per location (so you cannot install two scripts in http://domain. NOTE: You can install scripts in the main domain (http://domain. for example). You will be asked a few simple questions that will determine where the script gets installed and also the administrative account login details.domain. You can return to the main Fantastico screen at this point or enter an e-mail address to have the installation details e-mailed to the address you specify. Click on (2) New Installation to start the installation process. If you choose to remove the script. a subdomain (http://sub. To start. you will be prompted to upgrade the installed script. select a (1) script you are interested in from the sidebar on the right. On the left you will see a short description of the script you've selected as well as links to (7) support information for the scripts and (3) installation details including the amount of disk space required to install this script.

Dutch. Polish. you can get an overview of all of the scripts you've installed with Fantastico and see the installed version of the scripts and links to upgrade them. By default. if available. Leave the e-mail address field blank to disable notifications. Portuguese. Select the Email Notifications option and enter an e-mail address to get notified. You can also choose to have Fantastico send you e-mail when one of the scripts that it has installed has an available update. German. You can also choose to get reminded every day that there are available updates or only one time (when the update is first released).34 . Spanish and Swedish. NOTE: While using web scripts can really improve the functionality of your website. You do that by changing the option in the Side Menu Appearance item. you can choose to switch to drop-down menus so the sidebar isn't so cluttered. However. Clicking on the small red circle will log you out of cPanel completely. it is important that you keep all scripts updated. You can also change the displayed language to something other than English by selecting the Language item. Finally. cPanel Guide 11. Fantastico shows all options and features in one long list.NOTE: Fantastico can only update scripts that it has installed. Using Fantastico is a simple way to keep your scripts updated. At the very top of the Fantastico interface are (8) links back to cPanel or the main Fantastico screen. Fantastico has a few other settings and features you can access accessible in the Extras section. Indonesian.171 (C) 2012 Surpass Hosting . Fantastico currently supports English. French. The primary way hackers break into sites is by using known bugs in popular web scripts. You can change how items are listed in the sidebar. Italian.

There is a lot of great software out there that you can use on your website. Softaculous Web Script Autoinstaller We are in the middle of migrating to Softaculous to handle web-based software installation.Softaculous Learn how to use Softaculous to install and manage popular web scripts.172 (C) 2012 Surpass Hosting .34 . Softaculous or both. However. so your cPanel account may have Fantastico. if you're not cPanel Guide 11.

Enter part of what you are looking for and only the items matching your search will be displayed in the sidebar. The amount of space required to install it. Finally. By default. When done you will be shown the links to access the main script and the administrative interface. it will appear under the list of (6) Current Installs. You may or may not have luck with the import. Click it to start the upgrade process. If it works. but it generally includes specifying where you want the script installed. there will be an upgrade icon here. so please be patient. but it can also install various frameworks. then Softaculous will track the install and offer to upgrade it in the future (or uninstall it). The installation process may take some time. You can see support information.). It handles all of the "heavy lifting" for you. You will see the date and time you installed the script.34 . Answer a few questions and shortly you will have software installed on your website. javascript and now even Perl applications. Depending on the script. Once you've selected a script you are interested in. You cPanel Guide 11. Because Softaculous offers so many scripts.173 (C) 2012 Surpass Hosting . etc. For that reason. see Ratings or read or write a Review of this script and tell Softaculous to try to import the details of another script that you've installed either manually or via some other autoinstaller. try out a Demo of this script (which is actually hosted on Softaculous' own server). Click the small arrow icon to the right of a category you are interested in to reveal the items in that category. You are currently on the Overview tab. the script administrative details and password (Softaculous offers a random password generator. you can rate the software to let people know if you like it or not. You can click on the Features tab to view more information concerning what this script can do for you. the latest version available (along with a "chat bubble icon" next to the version that you can click on to inform Softaculous' maintainers that there is a newer version of the script available than the one that is currently offered in Softaculous). the currently installed version and a set of options that relate to that particular installation. If this script is something you want to install. Softaculous can not only install lots of PHP-based web scripts. but the passwords are rather short and not as secure as they could be) and core script information (site name. click on the Softaculous item on the cPanel home screen. To install a new copy of this script. you can enter an e-mail address to get a copy of your install details sent to that address or choose to install the script without doing that. look at Screenshots. but you can switch to the other types of scripts/frameworks by clicking the appropriate (2) Scripts category. Once done. a description of it and some basic information about it will appear in the (3) main section of the screen. it may be difficult to find one you are looking for. then you need to direct your attention to the (4) actions list that appears just above the script description. ready for use! To get started. all of which can be accessed in the (1) sidebar on the left of the screen.comfortable installing a web script yourself. the list shows all of the scripts written in PHP. select the Install tab and fill out the required information. If there is an update available. the exact information you will asked for will vary. Once a script is installed. Softaculous offers a large number of scripts and frameworks that it can install. including links to the script as well as to the administrative area. we offer Softaculous. there is a (5) Search feature.

The envelope icon will let you change Softaculous' e-mail settings. you may want to backup your data with cPanel or handle your backup manually using FTP.174 (C) 2012 Surpass Hosting . Click the zipped folder icon from the overview screen to back up the installed script and data. the box will take you to a screen listing all of your Softaculous-managed installs so you can upgrade. there will be an upgrade icon here. If you have several installed scripts. edit or remove them. you can select several of them by clicking the checkbox next to each one you want to do something with and then select the option from the "With Selected" drop-down list and click GO. the backup creation may take a long time or even fail if the script is too large. The next icon will let you view (and even change) some of the key details relating to this installation. Here you will be able to download the compressed backup. You will be asked to confirm the upgrade before starting. restore the install from this backup or remove the backup so it doesn't take up disk space in your account any more. Note that backups can be CPU intensive and you should try to do your backups during off-peak hours to be kind to other users on the system. Using Softaculous is a simple way to keep your scripts updated. You can control what sorts of things Softaculous will e-mail you about and what address it sends these e-mails to. it is important that you keep all scripts updated. Also. the time zone setting and the default state of the script category menus in the sidebar. the arrow will take you to Softaculous' script demo site. Finally you can click on the X icon to delete this installation. Finally. Click it to start the upgrade process. At the very top of the Softaculous screen are a bunch of (7) feature icons that will take you to different areas of Softaculous. the house icon will take you to the main Softaculous home screen. the star will take you to the script rating feature.an update available. The round chasing arrows icon will allow you to try to import installs make by other autoinstallers like Fantastico so that Softaculous can manage it from now on. After the backup Softaculous will place it in the Backups and Restore section (more on that in a bit). The primary way hackers break into sites is by using known bugs in popular web scripts. The zipped folder and arrow icon will allow you to mange your Softaculous backed up scripts. If so. NOTE: While using web scripts can really improve the functionality of your website. the question mark icon displays some basic help information about Softaculous. The blueprint and hammer icon will take you back to cPanel.34 . cPanel Guide 11. This will take you to a screen where you can choose what to back up and then actually have the script handle the backup. backup. The wrench and screwdriver icon will take you to the Softaculous settings screen where you can set the default Softaculous interface language. You will be asked to confirm your choice before the script is actually removed.

34 .175 (C) 2012 Surpass Hosting .Advanced Features cPanel Guide 11.

However. Most people will never need to add anything here. separated by spaces and then click the (3) ADD button. if you want to add or override a handler. All of these features are in the cPanel Advanced section. cPanel Guide 11. Adding and Removing Custom Apache Handlers There are some features that cPanel provides for users with more advanced or unusual needs but that aren't required for typical site operation. This allows you to quickly add or change the way Apache (the web server our servers use) handles certain file extensions.176 (C) 2012 Surpass Hosting .Apache Handlers Learn how to define new Apache handlers in cPanel. because Apache automatically knows how to handle all of the most common extensions. The first of these features is the Apache Handlers item.34 . just enter the specific (1) handler and the (2) extensions you want to be handled.

cPanel Guide 11.htaccess file in the public_html directory. MIME types will be discussed later. You cannot remove the system handlers.177 (C) 2012 Surpass Hosting . Apache Handlers tell Apache (the web server) how to handle certain types of files internally.You will see a list of your custom handlers and the system default handlers at the bottom of this screen. You can break your site if you are not careful. This feature works by adding or editing an "AddHandler" directive to your . NOTE: Be careful when adding or editing handlers. though. They are not the same thing. You can remove user defined handlers.34 . A bad handler may cause certain file types to be downloaded to the visitor's computer when accessed or generate a 500 error or a blank page. Do not confuse Apache handlers with MIME types. by clicking the (4) X in the Remove column. but you can override them with your own handlers if you want.

You can use any method you prefer. You will have three tools to choose from. you can increase the size of the image if you wish. cPanel's File Manager. just as with the thumbnailer. The thumbnailer creates separate. etc. However. It may take a while to finish. suitable for use as thumbnails on your site. When done. The thumbnailer allows you to navigate your account in the same way as other cPanel features do. smaller versions of large pictures. Select the small icon of a folder next to the name of a directory you want to navigate into and then click on the actual name of the directory to tell thumbnailer you want to create thumbnails of the pictures inside that particular directory. WebDAV. Click the folder icon next to a directory name to navigate into that directory cPanel Guide 11. This feature works by taking a directory full of images that you have already uploaded into your hosting account and creating smaller versions in a separate directory. not just shrink it.34 . To use them. The first thing you need to do is upload a directory full of images that you want to create thumbnails of. Clicking on the link will display that directory in cPanel's File Manager feature. You then select it as normal. FTP. click on the Image Tools item on the cPanel home screen. This feature supports most popular image formats including The image scaler feature resizes a single image at a time and unlike the thumbnailer.Image Management Learn how to edit images in cPanel. you need to have already uploaded the image you want to resize to your hosting account.). displaying the progress. you will see a link to the directory that cPanel has created specially to hold the new thumbnails (your originals are not modified).178 (C) 2012 Surpass Hosting . Working with Images cPanel offers a few tools that help you prepare images for use on your web site. cPanel will then ask you how large you want to make the thumbnails and then it will get to work.

34 . cPanel will go to work and tell you if the conversion was successful. then you can click the RESET DIMENSIONS button. you can choose to keep a copy of the original (unmodified) file with a new file name or you can uncheck the box and the original will be changed. Changing one dimension will automatically change the others to try to maintain the correct aspect ratio unless you uncheck the "Keep Aspect Ratio" box. you need to select a directory or a single file that you have already uploaded to your account. So you will need to manually delete any files you don't want. There is no going back once you click the SCALE IMAGE button. so make sure that is what you want. Click the folder icon next to a directory that you want to navigate into and click on the title of the directory or file you want to convert. The original files will remain in place. If you want to return the various settings to the original ones prior to committing changes. The convert image format feature attempts to turn a file saved in one common format to another common format of your choice while keeping as much of the original picture data as possible.179 (C) 2012 Surpass Hosting . Once you do. but they will be joined by the newly converted files. You will be shown the file and asked for the new dimensions. You will be asked to select the destination format for the converted file. Finally. Once again. cPanel Guide 11.and click on the file name to select that file to work on. either in pixels or in a percentage (100% being the same as the current dimensions).

34 . This is called fancy indexing and can be convenient if you want to offer a directory full of items for people to view or download.html.htaccess files automatically cascade to all directories contained inside the current directory (unless another . etc.htaccess file in a subdirectory overrides the setting). index. you can choose a new setting cPanel Guide 11. Once you select the directory you want to change the indexing for.html. you don't need to create a special HTML or PHP page with links to each file or directory. Remember that settings in . so you can control the behavior of the web server by clicking on the Index Manager item on the cPanel home page. Index Manager By default on our servers.) the web server will display all of the directories and files in that directory with the file names and small icons for each file type.180 (C) 2012 Surpass Hosting .htaccess file in the directory you choose. You can select any web-accessible directory and set the options for it. However. if you access a directory in your site that does not have an index file (index.php. default.Web Index Management Learn how to control what the web server does if a directory does not contain an index file. With fancy indexing on. you may not want to allow people to see the files and directories. NOTE: This feature works by modifying the . This means that you can change most or all directories settings just by selecting public_html as the directory you want to change index settings for.

htaccess file above the current directory or the default fancy indexing if no settings are specified) or switch to no indexing (anyone trying to access a directory without an index file will receive a 403 error (forbidden). click (2) SAVE to apply the change.by selecting (1) the appropriate radio button.34 . You can leave the default system setting (the setting inherited from a . cPanel Guide 11.181 (C) 2012 Surpass Hosting . Once you have selected your preferred setting. standard indexing (listing the directory and file names only without additional graphics) or fancy indexing (displaying file and directory names with graphics and some additional info to make it easier to identify the types of items the user is looking at).

Custom Error Pages Learn how to add and edit web error pages that get displayed to vistors. despite your best efforts.182 (C) 2012 Surpass Hosting . Most of the time. visitors to your site may run into an error or problem when visiting your site. Apache Custom Error Pages Sometimes. they've tried to load a page that doesn't exist) cPanel Guide 11.34 . our web server will display a very basic error page that lets the user know there has been a problem (for example.

There are some buttons above the text editor to input some special HTML codes to display information to the user (like the user's IP address. This will display a custom text editor that will allow you to input raw HTML code or plain text that will be displayed in a user's web browser if they see this particular error type. To get started with this feature.but that error page isn't very descriptive and won't match the look of your web site. etc. requested page. but if you click Show All HTTP Error Status Codes then you can create custom error pages for any web server error code. click on Error Pages on the cPanel home screen. In this case. There are (3) two tabs at the top of step 2. You can use cPanel to enter custom error pages that get displayed on your site instead of the default ones. Once done editing the page click the SAVE button at the bottom of the screen. web browser. If you already have a custom error page then the existing page's code will be displayed. The first tab shows only the most common error numbers (the ones you are most likely to want to create custom error pages for). you need to enter the administrative area for the web script you've installed and edit the error pages there instead of in cPanel.183 (C) 2012 Surpass Hosting .). you can (1) select the domain you want to edit the error pages for and then (2) click the error number you want to edit. If you are hosting several domains with your cPanel account. cPanel Guide 11. NOTE: Many popular web scripts include their own error handling code so you won't see the custom error pages you've designed.34 .

edit and remove cron jobs in cPanel. cPanel Guide 11.184 (C) 2012 Surpass Hosting .34 .Cron Jobs Learn how to add.

Working with Cron Jobs You may need to be able to execute certain commands or scripts at a specific time or interval. cPanel allows you to set up regularly scheduled items like this via something called a cron job. cPanel Guide 11.34 . In order to set this up you need to click on the Cron Jobs item on the cPanel home screen.185 (C) 2012 Surpass Hosting .

2) The jobs are run on the server time.34 . 23 is 11 PM 4) An asterisk (*) covers every instance in that field (for example * in the minute field will run the job every minute (depending on the other fields. you have to first choose the time you want the job to run. 7) A dash (-) specifies a range of values in a time field. 6 = Saturday). To set one up.Setting up a cron job tells our server to run a particular command at a specified time. to only errors to the output of the script or a notification that it was run successfully. By default you should expect to receive the output of the command you are running (just as you would see on screen if you ran that same command via the command line. 4 = Thursday. You can specify a specific time or the frequency you want the command you specify to be run. Our servers typically use the time zone that they are physically located in (US Eastern time in most cases). of course. this is handy if you have a web script installed that needs to perform certain tasks even if no one is visiting your site (like checking a mail account or running cleanup tasks). For example. the time you want your job to run and the actual command you need the server to execute. of course). entering 0. 5) A / symbolizes "divided by" and will divide how often the job runs by the amount you specify. 3 = Wednesday. click the (2) UPDATE EMAIL button. you should first make sure you enter an e-mail address that you check regularly into the (1) Email field. For example. 5 = Friday. */15 in the minute field will run the job every 15 minutes (every minute divided by 15 is every 15 minutes or 4 times per hour. 0 is midnight. depending on the settings in the other fields. 2 = Tuesday. entering 1-30 in the minute field would run the job every minute between the first and thirtieth minute each hour (depending on the settings in the other time fields). Your typical cron job is made up of two parts. The output of any cron jobs you enter will be sent to this address. Here are a few examples of correct time values and what they represent: cPanel Guide 11. depending on the settings in the other time fields. The output can vary.) 6) A comma (.) separates discreet values in a time field.186 (C) 2012 Surpass Hosting . hours (valid range 0-23). days (valid range 1-31). but you need to understand a few basic things before you can use it properly: 1) There are separate fields for minutes (valid range 0-59).20. To set up a task. 12 is noon. from nothing at all. 3) Hours are handled in 24 hour/military style (rather than using AM or PM). in that order.35 into the minute field will trigger the job to run at the top of the hour and then again at 20 minutes and 35 minutes past the hour. The time component of a cron job is fairly flexible. 1 = Monday. The current e-mail setting will be displayed above that field and if you want to change it. months (valid range 1-12) and weekdays (valid range 0-6 with 0 = Sunday. For example.

at the top of the hour and 30 minutes after the hour between the hours of 9 AM and 5 PM only on weekdays (Mon-Fri). When you are done. Alternately.30 9-17 * * 1-5 .Runs the job two times per hour. Run it so the server has time to finish and "rest" a bit between runs. NOTE: We ask that you DO NOT run cron jobs every minute.php /usr/bin/curl /home/YOURCPANELUSERNAME/public_html/scriptdirectory/script. cron jobs always use the server default values unless you specify a different configuration (php.ini /home/YOURCPANELUSERNAME/public_html/scriptdirectory/script. So for example. then don't run the job every 3 minutes.187 (C) 2012 Surpass Hosting . You can do that using: php -c /home/YOURCPANELUSERNAME/path/to/custom/php. click the (6) ADD NEW CRON JOB button to set up the job. if your cron job takes 3 minutes to run. 1 0 1 1 * .Runs the job every 30 minutes.ini) file. Also. you can manually enter the values you want to use in each (4) time field. The job will be active right away (though it won't trigger until the conditions you've set up for timing are met). every day. cPanel Guide 11. So if you have a PHP script you need to execute. you enter the command you want to run into the (6) command field. For example: /usr/bin/php -q /home/YOURCPANELUSERNAME/public_html/scriptdirectory/script. Cron jobs can be quite process intensive and running them too often will negatively affect server performance for everyone. please make sure that you give your cron job enough time to finish running before starting the next iteration. Just select the one you want from the appropriate (3) drop-down list and cPanel will set all the values accordingly. server time.php /usr/bin/wget -q /home/YOURCPANELUSERNAME/public_html/scriptdirectory/script. you shouldn't ever need to run a cron job more frequently than every 5 minutes.34 . Generally.php Although you may have customized PHP settings in your account. lynx or curl to execute the script. wget. Next.*/30 * * * * . The command would be as you would enter it if you were logged into the server and executing it via the command line. We reserve the right to ask you to adjust your cron start times or even disable a cron job if we find that it is causing problems.Runs the job once a year on January 1 at 12:01 AM. cPanel includes common time values pre-configured. you can use php. 0.php Check the documentation for the script you are using if you are uncertain what needs to be executed.

188 (C) 2012 Surpass Hosting . This includes the time settings for each job as well as the command being run. You can choose to (8) edit or delete each job separately.Any cron jobs you've added will be listed in the (7) Current Cron Jobs section.34 . cPanel Guide 11.

Network Tools Learn how to use a few common network tools to try and track down issues. the Trace Route tool. will not work (we do not allow outbound trace routes). For security reasons. cPanel Guide 11. that have our sever check the DNS records for any valid domain you enter to find out the A Record (the IP address the domain points to). There are two different tools. Domain Lookups. This typically shows each machine the packets pass through to reach you. Sometimes a failure between you and our server can cause you not to be able to properly access your site. Trace routes are handy if you are having problems accessing your site and you want to see if the problem is caused by a machine somewhere between our server and your current location. To use them. You can enter your own domain name or some other domain and cPanel will tell you what IP address the domain resolves to and show you the output of the tool used to gather that information (dig). the second tool that cPanel offers.189 (C) 2012 Surpass Hosting . even though your site is online and operational for others. click on Network Tools on the cPanel home screen. Using Network Tools for Troubleshooting cPanel includes a couple of tools that can sometimes help to track down problems with your site. The trace route attempts to trace the path packets of information take to get from our server to your current location.34 .

If needed. they will explain how to run a trace route or path ping (which is similar to a trace route with slightly different output). we will work to fix it. please contact our support team. cPanel Guide 11.If you think you may be having such a problem.34 . If there is a problem on our network. but if there is a problem locally (on your end) you may need to contact your ISP for assistance.190 (C) 2012 Surpass Hosting .

MIME Types Learn how to add or remove custom MIME types so media is handled properly in your web browser.34 . streaming media. Although MIME is still the most commonly used name for these codes. MIME stands for Multipurpose Internet Mail Extensions and it was originally designed for use by e-mail clients (thus the name). they can also be referred to as Internet media types (which is perhaps more cPanel Guide 11. scripts written in various languages like PHP or Perl. RSS. Adding Custom MIME Types There is a wide variety of content available on the web including HTML pages. etc. movies. Did you ever wonder how your web browser knows what to do with all of this content? Why does your browser display rendered html pages but offer to save a .191 (C) 2012 Surpass Hosting .zip file you click on? Much of this is handled through MIME types.

To control which file extensions are defined by that particular MIME type.) know how to handle the data that is being sent to it. The MIME types you add will override the default system MIME Types if they overlap. e-mail program. cPanel Guide 11. visit this page: http://www.descriptive of their current use). For example.php).iana. This is done through simple plain-text codes and file extensions (like . To set up a new MIME type or to alter one of the default system types. MIME types specify how a user's web browser handles files sent to it by our web server.org/assignments/media-types/index.html Any custom MIME type additions or changes you make will be listed in the (4) User Defined MIME Types section of this screen while the default MIME type associations will be listed in the (5) System MIME Types section.html or .192 (C) 2012 Surpass Hosting . NOTE: This feature works by editing the . text/html is the MIME type for HTML content. enter the extensions without a period and separated by a space. For example: html htm html5 NOTE: If you want to see a list of all of the defined MIME types that are available. so these types will apply to nearly all of your web content. NOTE: Although they may seem similar.htaccess file in your public_html directory adding the MIME types you've specified. MIME types all follow a basic pattern. they are designed to accomplish the same task: Let your client (web browser. Apache handlers and MIME types are not the same. Whatever you choose to call them.34 . while handlers tell our web server how to deal with certain types of files internally. you can do so using the MIME Types feature on the cPanel home screen. but if you want to add or edit types. etc. you can enter the type you want to change into the (1) MIME Type box. Our web servers have a lot of MIME types already set up for the most commonly used media types. A content type followed by a / and the specific sub type.

34 .Closing cPanel Guide 11.193 (C) 2012 Surpass Hosting .

If you have any questions or concerns not covered here.34 . We're always here to help you! We appreciate your business and hope that you will recommend your friends and family come to us for all of their hosting needs. please feel free to contact our support team at any time. cPanel Guide 11. day or night.194 (C) 2012 Surpass Hosting .Final Thoughts Thanks for reading this guide! Some Final Thoughts We hope you've found this guide to be useful.