In this tutorial we will walk you through a manual installation of osCommerce, which is a popular free open-source E-commerce software option. osCommerce is written in PHP, and requires a mySQL database to function.
We also have a guide on how to install osCommerce fom Softaculous, which is a simplified installation.
Minimum System Requirements:
PHP 4, but PHP 5 is recomended.
mySQL 3, but version 5 is recommended.
Note: Webhosting Hub's servers meet these requirements.
- Use the MySQL database wizard in cPanel to create the database, database user, and add the user to the database. Be sure to write down the database name, username, and password you created as we will use this later in this tutorial.
- Navigate to the official osCommerce website.
- Click the Products button on top.
- From the drop-down menu select the latest full package (in my tests it was titled v2.3.3 Full Package), and click the green Download button.
The file will pop up, download it to your local computer. At the time this guide was written, the file I downloaded was titled
Extract & Upload:
- Extract the file you downloaded to your local computer. At the time this guide was written the folder is called: oscommerce-2.3.3
- Using FTP upload the contents of the catalog folder, and the other files to the location you want your osCommerce website to exist. For example if you want the website to show up on your main website address mydomain.com, you would upload the files to the public_html folder directly.
If you want the site in a subfolder such as: mydomain.com/eshop, you would create a folder in the public_html folder titled eshop and upload the files directly to that folder.
- Navigate to the web address where you uploaded the files. For example if you uploaded the file to the public_html folder you would navigate to:
The New Installation menu will come up, and check your server's capabilities. Click the Continue button to proceed.
- The Database Server menu will come up and ask for specific settings. Fill in the fields with the requested information. Remember, these are the database settings you created earlier in this tutorial.
||Since the database is on the same server as the install you will use localhost. If you are connecting to a database remotely, you will typically use the domain name.
||Enter the username you setup previously.
||Enter the password you setup previously.
||Enter the name of the database you setup previously.
After filling in the fields select the Continue button.
- The Web Server menu will come up, and request some specific information.
||Enter the address of your oscommerce website, include the http://
Example: http://mydomain.com, or http://mydomain.com/eshop
|Webserver Root Directory
Enter the root directory of the osCommerce install.
Example: If it is in your public_html folder, the location will be:
If it is within the public_html folder, it will be:
After filling in the fields click the Continue button.
- The online store menu will come up and request information, fill in the required fields.
||The name of the online store that is presented to the public.
|Store Owner Name
||The name of the store owner that is presented to the public.
|Store Owner E-Mail Address
||The e-mail address of the store owner that is presented to the public.
||The administrator username to use for the administration tool.
||The password to use for the administrator account.
||The time zone to base the date and time on.
After filling in the fields, click the Continue button. You will see a notification stating "The installation and configuration was successful!" and a list of Post-installation notes.
- Using FTP locate and delete the install folder, then rename the admin folder for security purposes. For example rename it: osadmin, or admin-login
- In the includes folder locate the configure.php file and change the file permissions to 4-4-4 or read-only.
Congratulations, now you know how to perform a manual installation of osCommerce! Next, login to the Admin panel to begin working on your osCommerce eshop.