From Zen Cart(tm) Wiki
Revision as of 14:42, 30 April 2009 by Stark (talk | contribs)
Jump to: navigation, search


If you don't find the information you need here, a tutorial discussing installation of zen cart can be found here. Briefly stated, you will need to:

  • Get a server.
  • Make sure you have the prerequisite software
  • Download the Zen Cart™ software and upload it to your server.
  • Create a couple of configuration files.
  • Configuration
  • Post Installation Steps
    • Configure Zen Cart™.
    • Security.
    • [optional] create a local copy for development and testing.

Get a server

You need to make sure that you have access to a server which can handle Zen Cart™.

  • If you want to install Zen Cart™ on a local PC (for development and testing, or because you have your own IP address and want to run a private server), you need to follow the instruction here.
  • If you do not yet have a host, you can choose one from Zen Cart™'s list of certified hosts.
  • If you already have a host, you need to make sure they provide the required software. Check to see if your host provides specific instructions for installing Zen Cart™.

Often host providers provide one-click installs, or their own private tutorials for how to set up Zen Cart™ on their systems. Check first for their documentation. The remainder of this page discusses how to set up Zen Cart™ on a remote host using FTP.

You will need to create and have access to a MySQL database on your server. You should consult your webhosts documentation for assistance. You need the following permissions on your MySQL user: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP. On an hSphere host, this would be "dba" access, or at least read/write.

Get the prerequisite software

To administer your Zen Cart™ site, you need the following software:

  • An FTP client, for example filezilla.
  • A text editor. No, MS Word is not a text editor. Pick one you like, there are countless. Try Notepad++.

Upload Zen Cart™ to your Server

  • Go here and download the most recent version of Zen Cart™.
  • Unzip the package to a folder on your local PC.
  • Use FTP to transfer the contents of the Zen Cart™ folder (and files) to your webserver. Where should you put it? That depends on your webserver. You'll have to figure it out with them. Normally you would put the files in the already-existing public_html or htdocs folder which you find on your server.

Create configuration files

You will need to create a couple of configuration files, and change their permissions (using the chmod or permissions feature of your FTP client) to 777 (read-write-execute for anyone). Note that [ZENHOME] below means the folder where you've put the Zen Cart™ contents.

  • [ZENHOME]/include/dist-configure.php
  • [ZENHOME]/admin/dist-configure.php

Set folder permissions

You will need to change the permissions on the following directories to 777 (note [ZENHOME] refers to the directory containing your Zen Cart files).

  • [ZENHOME]/cache
  • [ZENHOME]/images -- do this folder recursively (all subfolders, and all their subfolders, and all their...).
  • [ZENHOME]/includes/languages/english/html_includes/ -- recursively
  • [ZENHOME]/media
  • [ZENHOME]/pub
  • [ZENHOME]/admin/backups
  • [ZENHOME]/admin/images/graphs

Other folders and files can have permissions of either 644 (typical) or 444 (rare) depending on your webserver configuration.


This section has yet to be written.

Post Installation


For starters, take a look at this admin checklist.


Steps for securing your Zen Cart installation are discussed in Important_Site_Security_Recommendations

Create a local copy for development and testing

This topic is discussed in detail here.