How to install CS-Cart manually
This article describes how to manually install CS-Cart, a shopping cart application.
CS-Cart is compatible with all A2 Hosting accounts. However, you must install it manually.
Although A2 Hosting servers are compatible with a wide variety of software applications, we cannot provide troubleshooting assistance for application-specific issues.
To install CS-Cart:
- Download the CS-Cart application at http://www.cs-cart.com/download-cs-cart.html to your computer.
- Use FTP to upload the installation file to the public_html directory of your A2 Hosting account. For information about how to access your account using FTP, please see this article.
This step assumes that you want to run CS-Cart from your domain's document root (for example, example.com). If you do not want to do this, create a directory beneath the public_html directory, and transfer the installation file to that directory. For example, to run CS-Cart from example.com/cart, create a directory under public_html named cart, and then transfer the installation file to it.
- Log in to your account using SSH. For information about how to access your account using SSH, please see this article.
- Extract the application files. To do this, change to the directory where the installation file is located, and then type the following command:
tar -xzvf cscart_v4.0.2.tgz
The exact filename may differ slightly, depending on the version you downloaded.
Set the correct file permissions. To do this, type the following commands in the directory where you extracted the files:
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
Use cPanel to create a MySQL database and database user for the application. You will need this information during the web configuration process.
For information about how to create a MySQL database and user, please see this article
Use your web browser to go to the installation URL. The installation URL is one of the following:
- If you are installing the application in the domain's document root directory, use http://www.example.com/install.
- If you are installing the application in a subdirectory, use http://www.example.com/directory/install, where directory represents the path to the application files.
- Select the I accept CS-Cart license agreement check box, and then click .
- Under Server configuration, in the MySQL database name text box, type the name of the database that you created in step 6.
- In the MySQL user text box, type the name of the database user that you created in step 6.
- In the MySQL password text box, type the database password that you specified in step 6.
Under Administration settings, in the Administrator's e-mail text box, type the adminstrator's e-mail address.
The administrator's e-mail address is used as the administrator username when you log in.
- In the Administrator's password text box, type a password for the administrator.
- In the Main language list box, select the language for the website.
- To install sample data, select the Install demo data check box.
- To send anonymous usage statistics about your installation to CS-Cart, select the Help us improve CS-Cart check box.
- Click . The installation process begins.
After a few moments, the Licensing mode dialog appears. Select the licensing mode that you want:
- If you already have a license number, select Full, and then type the license number in the License number text box.
- If you do not have a license number, select Trial or Free.
- Click Installation successfully finished message appears.. When the installation process finishes, the
- To view the dashboard immediately, click
. Alternatively, to set up the application, click .
After you finish installing CS-Cart, you should complete a few additional steps to help secure your site:
- Delete the installation file that you uploaded in step 2 of the previous procedure, or move the file to a directory on your account that is not publicly accessible.
- At the command line, type the following commands to set more restrictive file permissions:
chmod 644 config.local.php
chmod 644 design/.htaccess images/.htaccess
chmod 664 var/.htaccess var/themes_repository/.htaccess
chmod 644 design/index.php images/index.php
chmod 664 var/index.php var/themes_repository/index.php