Knowledge Base

How to install CS-Cart manually

This article describes how to manually install CS-Cart, a shopping cart application.

Installing CS-Cart

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:

  1. Download the CS-Cart application at to your computer.
  2. 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, 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, create a directory under public_html named cart, and then transfer the installation file to it.
  3. Log in to your account using SSH. For information about how to access your account using SSH, please see this article.
  4. 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.
  5. 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
  6. 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.
  7. 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
    • If you are installing the application in a subdirectory, use, where directory represents the path to the application files.
  8. Select the I accept CS-Cart license agreement check box, and then click Next step.
  9. Under Server configuration, in the MySQL database name text box, type the name of the database that you created in step 6.
  10. In the MySQL user text box, type the name of the database user that you created in step 6.
  11. In the MySQL password text box, type the database password that you specified in step 6.
  12. 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.
  13. In the Administrator's password text box, type a password for the administrator.
  14. In the Main language list box, select the language for the website.
  15. To install sample data, select the Install demo data check box.
  16. To send anonymous usage statistics about your installation to CS-Cart, select the Help us improve CS-Cart check box.
  17. Click Install. The installation process begins.
  18. 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.
  19. Click Select. When the installation process finishes, the Installation successfully finished message appears.
  20. To view the dashboard immediately, click Close. Alternatively, to set up the application, click Go to the Settings wizard.

Post-installation configuration

After you finish installing CS-Cart, you should complete a few additional steps to help secure your site:

  1. 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.
  2. 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

More Information