Installing CS-Cart

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

Installing CS-Cart

CS-Cart is compatible with all hosting.com accounts. However, you must install it manually.

📘

Note

Although hosting.com servers are compatible with a wide variety of software applications, we cannot provide troubleshooting assistance for application-specific issues.

To install CS-Cart, follow these steps:

1. Download the CS-Cart application at http://www.cs-cart.com/download-cs-cart.html to your computer.

2. Use FTP to upload the installation file to the public_html directory of your hosting.com account. For information about how to access your account using FTP, please see this article.

   📘

   Note

   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 publichtml 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:

   Bash

   unzip cscart_v4.6.3.SP1.zip
   

   📘

   Note

   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:

   Bash

   find . -type f -exec chmod 644 {} \;
   find . -type d -exec chmod 755 {} \;
   

6. Use cPanel to create a MySQL database and database user for the application. You will need this information during the web configuration process.

   📘

   Note

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

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.

    📘

    Note

    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 the x (close) icon. Alternatively, to set up the application, click Run 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 command to set more restrictive file permissions:

   Bash

   chmod 644 config.local.php
   

More Information

• For general information about CS-Cart, please visit http://www.cs-cart.com.

• To view the online CS-Cart knowledge base, please visit http://kb.cs-cart.com.