Doteasy Tutorials - Scripting

Setting up osCommerce 2.2

osCommerce is an online shop e-commerce solution developed by the open source community. Its feature packed out-of-the-box installation allows store owners to setup, run, and maintain their online stores with minimum effort and with absolutely no costs or license fees involved. It also include support for many popular payment gateways and alternative payment methods.

This tutorial will guide you through the osCommerce setup and installation process on our servers. It is assumed that your account has support for PHP and MySQL database and that you have already created your database.

To protect your customer information, it is highly recommended that you also have an SSL certificate for data encryption. Click here for more info on SSL certificates. Contact Doteasy to purchase your SSL certificate today.

Part A - Downloading the Script

Download our customized version of the osCommerce 2.2 script. It has been modifed to be compatible with our servers. Click here.

The osCommerce distribution file that you will download is in .zip compressed format. Unpack this archive in a temporary directory on your computer using decompression software.


Part B - Uploading Files to Server

Before you begin, please ensure that you have created your MySQL database on your web server via your Site Administration Panel. View the database creation tutorial.

If your MySQL database is already created, you are ready to upload osCommerce files to the server.

Start your FTP software and connect to your web server

From your osCommerce unpacked files, upload the entire folder and contents of the /catalog folder to the /var/www/html/ location on your server.


Part C - Software Configuration

Access the osCommerce configuration script with your web browser,

(Replace with your domain name)

Click Install.

Please customize the new installation with the following options:

Please enter the database server information:

Database Server:
Username: Doteasy memberID
Password: database password
Database Name: database name eg, yourdomain_com_-_db
Persistent Connections: Uncheck
Session Storage: Select Database

A test connection made to the database was successful. Click Continue

The database import was successful! Click Continue

Please enter the web server information:

WWW Address:
(Replace with your domain)
Webserver Root Directory: /var/www/html/catalog/
HTTP Cookie Domain:
HTTP Cookie Path: /catalog/
Enable SSL Connections: check
(more info on SSL)

Click Continue.

Please enter the secure web server information:

Secure WWW Address:
(Replace with your domain)
(more info on SSL)
Secure Cookie Domain:
Secure Cookie Path: /catalog/

Click Continue.

Click Continue to confirm.

Configuration should be successful.


Part D - Security

Your installation directory is located at: /var/www/html/catalog/install. Using your FTP software, please remove this entire directory for security reasons as it is no longer needed.

Change file permission for the file configure.php, located at /var/www/html/catalog/includes/configure.php to 4-4-4 or:

  • Owner: Allow Read only
  • Group: Allow Read only
  • Others: Allow Read only

To change file permissions using CuteFTP, select the file by clicking on it once on the remote system side and then right-click on the file to bring up the option menu and select CHMOD.

To assign the correct file permissions under Owner check Read, under Group check Read, and under Other check Read . The manual value of the permission is 4-4-4.

Use your server Password Protected Directories function to protect your shopping cart admin page. Login to your Site Administration Panel. In the shortcuts area, click Protect Directories (File Manager section).

If you have not done so already, create an HTAccess group, then specify the user or users who belong to the group. You need to create at least one group and add at least one user to that group before you can protect a directory. Click Manage Groups.

Enter Group name and click ADD.

Click Manage Users.

Enter UserName, Password, select group and click Add/Edit.

Click Protect Directories.

Select the directory or folder that you would like to protect. For osCommerce users you need to protect /var/www/html/catalog/admin/. Click .

In the AuthName field, enter 'osCommerce Admin' as the descriptive name for the directory. Click Protect.

An 'X' will appear on the lock icon and the folder is now protected.


Part E - Email Address Configuration

Login to Doteasy Webmail to view your email server host name. After you login to Webmail, the URL address of the Webmail connection will display your email server host name. In this example the email server host name is Once you have found the host name, you may logout of Webmail and close your browser.

Access your osCommerce admin control panel at (Replace with your domain)

Click Configuration.

Select to configure E-mail Address.

Click Edit.


Specify the recipient email address using the following format and replace with your mail server name:

Click update.


Your osCommerce setup is now complete.

View your shopping cart at:

Access your osCommerce Admin Panel at:

(Replace with your domain name)

For more information on osCommerce please visit the osCommerce Community Support:


If you require additional assistance, please feel free to contact our customer service team:

Back to Tutorials Page