In this tutorial, we will show how to install CS-Cart v4 on an Ubuntu 14.04 VPS with Apache, PHP and MySQL installed on it. CS-Cart is a standalone shopping cart software based on PHP and MySQL, intended for building and managing an attractive storefront of any size. This guide was tested and written for Ubuntu 14.04 VPS, but it should work on any Linux distribution.
This install guide assumes that Apache, MySQL and PHP are already installed and configured on your CS-Cart virtual server. At the time of writing this tutorial, the latest stable version of CS-Cart is 4.2.4 and it requires:
- PHP >= 5.3 with the following PHP extensions enabled: CURL, Zip, Phar, MySQLi, GD Graphics Library version 2.0.x+ and FreeType font library. Also, safe_mode, magic_quotes_gpc, magic_quotes_runtime and magic_quotes_sybase settings should be disabled and allow_url_fopen and file_uploads setting should be enabled in php.ini
- Apache Web Server >= 2.0 compiled with mod_rewrite module and with the following directives allowed: DirectoryIndex, Deny, Allow, Options, Order, AddHandler, RewriteEngine, RewriteBase, RewriteCond and RewriteRule.
- MySQL >= 4.1 installed on your virtual server.
Download the latest version of CS-Cart available at https://www.cs-cart.com/download-cs-cart.html to the server and extract it using the following commands:
cd /opt unzip cscart_v4.2.4.zip -d /opt/cscart
Create a new MySQL database for CS-Cart on your server:
mysql -u root -p mysql> CREATE DATABASE cscartdb; mysql> GRANT ALL PRIVILEGES ON cscartdb.* TO 'cscartuser'@'localhost' IDENTIFIED BY 'your-password' WITH GRANT OPTION; mysql> FLUSH PRIVILEGES; mysql> quit
Create a new virtual host directive in Apache. For example, create a new Apache configuration file named ‘cscart.conf’:
touch /etc/apache2/sites-available/cscart.conf ln -s /etc/apache2/sites-available/cscart.conf /etc/apache2/sites-enabled/cscart.conf vi /etc/apache2/sites-available/cscart.conf
then, add the following lines to it:
<VirtualHost *:80> ServerAdmin email@example.com DocumentRoot /var/www/html/cscart/ ServerName your-domain.com ServerAlias www.your-domain.com <Directory /var/www/html/cscart/> Options FollowSymLinks AllowOverride All </Directory> ErrorLog /var/log/apache2/your-domain.com-error_log CustomLog /var/log/apache2/your-domain.com-access_log common </VirtualHost>
Edit the php.ini configuration file and add/modify the following lines:
file_uploads = On allow_url_fopen = On safe_mode = Off register_globals = off magic_quotes_gpc = Off magic_quotes_runtime = Off magic_quotes_sybase = Off session.auto_start = 0
Restart the Apache web server for the changes to take effect.
service apache2 restart
Move the CS-Cart installation files to the document root directory defined in the virtual host directive above:
mv /opt/cscart/ /var/www/html/cscart
Also, the webserver user (Apache) needs to be able to write to ‘/var/www/html/cscart/’ directory so you can easily accomplish that by executing the following command:
chown www-data:www-data -R /var/www/html/cscart/
Set the proper file permissions for CS-Cart to write to certain files and directories:
cd /var/www/html/cscart/ chmod 666 config.local.php chmod -R 777 design images var find design -type f -print0 | xargs -0 chmod 666 find images -type f -print0 | xargs -0 chmod 666 find var -type f -print0 | xargs -0 chmod 666
Open http://your-domain.com/install/ in your popular web browser and follow the easy instructions.
After finishing the installation it is strongly recommended to delete the install directory in your Apache’s document root:
rm -rf /var/www/html/cscart/install/
Also, change the access permissions for the files as advised below:
chmod 644 /var/www/html/cscart/config.local.php chmod 644 /var/www/html/cscart/design/.htaccess images/.htaccess chmod 664 /var/www/html/cscart/var/.htaccess /var/www/html/cscart/var/themes_repository/.htaccess chmod 644 /var/www/html/cscart/design/index.php /var/www/html/cscart/images/index.php chmod 664 /var/www/html/cscart/var/index.php /var/www/html/cscart/var/themes_repository/index.php
Do not forget to change the default administrator password.
That is it. The CS-Cart installation is now complete. Of course you don’t have to do any of this if you use one of our CS-Cart Web Hosting plans, in which case you can simply ask our expert Linux admins to install CS-Cart for you. They are available 24×7 and will take care of your request immediately.
PS. If you liked this post please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.