OSCommerce Installation through Fantastico

OSCommerce is a widely used shopping cart easily installed through the Fantastico section in your cPanel. This guide will walk you through the installation of OSCommerce and help you confirgure the cart to use either your dedicated SSL or the free shared SSL included with all of our shared hosting plans so you can securely accept orders at your store!

Step 1: Login to cPanel (login details are in your account information email).

Step 2: Record your server name for later usage (as shown below).

cPanel Server Information

Step 3: Click on the fantastico icon (as shown below).

Step 4: Click on the link for OS Commerce (under E-Commerce as shown below).

OS Commerce Fantastico Location

Step 5: Click on the link for New Installation (as shown below).

New OSCommerce Installation

Step 6 (MOST IMPORTANT STEP): Define the installation location (as shown below).

A. Select your domain name from the drop down menu.

B. Enter the name of a directory where you wish osCommerce to install.

WARNING! The "install in directory" field is where a lot of clients go wrong. You should enter a single word of a new folder that will be created for osCommerce. Do NOT enter ANY slashes!

C. Double check what you entered in the "Intall in directory" field. If you wanted your website visitors to access your oscommerce store when they went to http://yourdomain.com, you would NOT enter anything in the "Install in directory" field (you would leave it blank). However, if you already have a website (you have upload webpages), you would want to enter a directory name (single word) in the "install in directory" field. For example, in our image above, you can see we entered the word "store". If you decided to enter "store", you would access osCommerce by going to http://yourdomain.com/store/ (you would use your actual domain name though).

Step 7: Enter a username & password of your choosing (as shown below). Do not use the same username and password as in our example, choose your own.

Step 8: Enter a shop name, owner name, and email addresses (as shown below).

The shop name, owner's name, email sender, and your email address fields are all pretty self explanitory.

Enter your details and proceed to steps 9 and 10, which still falls under the Base configuration, but need a little more explanation.

Step 9: Set Use SSL to Yes (as shown below).

Step 10: Enter your Secure Server Hostname (as shown below).

If you have a Dedicated IP and SSL certificate for your domain name, you can just enter your domain name in this field. Otherwise, enter the Server name you recorded in Step 1, forward slash, tilde (~), your cpanel username ( centos.securenet-server.net/~acenet ).

Step 11: Select information you want to require from your clients (as shown below).

These are self explanitory variables and can be set to Yes (required) or No.

Step 12: Click Install OS Commerce (as shown below).

Step 12: On the next page, click Finish installation (as shown below).

END: YOU'RE DONE!

----------------------------------------------------------------------------------------------------------------

Auto-Installation Troubleshooting

Error: The installation can not be completed (exact error shown below).

Solution: Delete the images folder & .htaccess file in your public_html directory. Note that in this example we are trying to install OSCommerce into our public_html folder (i.e. we left Step 6B blank to install in the root directory). If you have already uploaded files or setup your website, you will want to make sure you save any files you may need before deleting them to allow OSCommerce to install.

Step 1 : Go to the main cPanel page and click File Manager (image shown below).

Step 2 : Click the folder icon on the left of the word public_html (as shown below).

Step 3 : Click on the word "images" (as shown below).

Step 4 : On the top right, click Delete this folder and all files under it (as shown below).

Delete this Folder and all files under it

Step 5 : Click on the word ".htaccess" (as shown below).

Step 6 : On the top right, click Delete File (as shown below).

Delete .htaccess

END: You're done. The installation should now be able to create it's own images directory and .htaccess file. Try installing OS Commerce again!

Back to cPanel Documentation »