Install osCommerce on Debian 8

 In Dedicated, VPS, Web


We will be using system with SSD for this tutorial. We assume that you already have Apache, MySQL and PHP installed and configured on your server.


# ssh root@server_ip

You can check whether you have the proper Debian version installed on your server with the following command:

# lsb_release -a

You should get this output:

Distributor ID: Debian
Description:    Debian GNU/Linux 8.3 (jessie)
Release:        8.3
Codename:       jessie


Make sure your server is fully up to date using:

# apt-get update && apt-get upgrade

Now create a database that will be needed for the osCommerce installation. Log into MySQL as root and execute the below queries:

# mysql -u root -p

mysql> CREATE DATABASE oscommerce;
Query OK, 1 row affected (0.00 sec)

mysql> GRANT ALL PRIVILEGES on oscommerce.* to oscommerceuser@localhost identified by 'your_password';
Query OK, 0 rows affected (0.00 sec)

Query OK, 0 rows affected (0.00 sec)

mysql> quit;


Navigate to Apache’s default document root ( /var/www/html/ ) and download the latest osCommerce version (during the writing of this article the latest version is 2.3.4) :

# cd /var/www/html/

# wget

Unzip the archive:

# unzip

Rename the unpacked directory:

# mv oscommerce-2.3.4/ oscommerce/

Give appropriate permissions to the below files so your web server can save the installation parameters accordingly. Execute the following commands:

# chmod 777 /var/www/html/oscommerce/catalog/includes/configure.php

# chmod 777 /var/www/html/oscommerce/catalog/admin/includes/configure.php

5. Continue the installation in web broweser

Now open your favorite web browser and navigate to: http://your_IP_address/oscommerce/catalog/install/index.php .

You will be welcomed by the osCommerce installation page.

Of course the PHP settings and required PHP extensions need to be enabled/installed so you can proceed with the installation. If everything is OK, click on Start to proceed with the installation. Next are the database settings.

Next, a page where you can configure your store settings will be opened. Fill the fields according to your needs and finish the installation.

Your store can be accessed at: http://your_server_IP/oscommerce/catalog/index.php and the osCommerce administration backend at: http://your_server_IP/oscommerce/catalog/admin/login.php

You are probably noticing the post-installation notes which say that you should delete the installdirectory, set correct permissions on some files and protect the administration tool. Execute the underneath commands:

# rm -rf /var/www/html/oscommerce/catalog/install/

# chmod 644 /var/www/html/oscommerce/catalog/includes/configure.php

# chmod 644 /var/www/html/oscommerce/catalog/admin/includes/configure.php

Now let’s password protect the osCommerce administration tool with the htpasswd utility. Execute:

# htpasswd -c /var/www/html/oscommerce/catalog/admin/.htpasswd your_user

You will now be prompted to enter a password, twice. After you enter the password you can check whether the credentials have been entered as expected:

# cat /var/www/html/oscommerce/catalog/admin/.htpasswd

6. Configure Apache

Now configure your Apache web server to check the .htpasswd file before serving the protected content. Open the Apache’s default config file with your favorite editor. We are using nano:

# nano /etc/apache2/sites-available/000-default.conf

paste the following in the VirtualHost directive:

<Directory "/var/www/html">
        AuthType Basic
        AuthName "Restricted Content"
        AuthUserFile /var/www/html/oscommerce/catalog/admin/.htpasswd
        Require valid-user

Save and close the file. Now restart Apache for the changes to take effect.

# service apache2 restart

You can now open http://your_server_IP/oscommerce/catalog/admin/login.php after which you will be presented with a username and password prompt.

Congratulations, you have successfully installed osCommerce on your Debian 8 system.

Recommended Posts

Start typing and press Enter to search