Documentation Home

# Welcome to Zen Cart®

Dear Zen Cart User,

Zen Cart is made available to you for your use, addition, changes, modification, etc. without charge, under Version 2 of the GNU General Public License.

While we do not charge for this software, donations are greatly appreciated, each time you install a new version, to help cover the expenses of maintenance, upgrades, updates, the free support forum and the continued development of this software for your online E-Commerce store.

Donations can be made on the Zen Cart Team Page

We appreciate your support.
The Zen Cart Team

# Zen Cart Requirements

For up-to-date requirements, see: Zen Cart Server Requirements.

While Zen Cart can run on Windows/IIS servers, Linux/Apache servers are recommended for best results.

# Online Documentation

This documentation was built at the time of the software release. The Zen Cart FAQ is updated constantly and may be more up to date. Please see upgrade documentation on the Zen Cart FAQ.

# Before You Start

## Getting Started

This is a basic guide to upgrading Zen Cart. If you have not yet installed Zen Cart, please see the 1.readme_installation.html file for installation instructions.

To upgrade Zen Cart, you will need the same basic tools you used to install and customize it in the first place:
- An FTP program
- A text editor friendly to HTML/PHP code
- phpMyAdmin or equivalent access to your MySQL database
- Your Control Panel for managing your webspace

Additionally, you will find that a file comparison tool such as WinMerge, Beyond Compare or ExamDiff (Linux) to be very helpful. (There is also BBedit for the Mac.)

# Performing your Zen Cart Upgrade

# Upgrading - Basic instructions

Zen Cart Upgrading - Basic instructions

READ THIS FIRST: How do I rebuild my site on the new version, instead of upgrading?

Detailed upgrade instructions that help you retain your customizations while upgrading to new features, can be found in this related article.

Before you begin, remember to make a complete backup of your files and database.

### A. If you want to PRESERVE YOUR CUSTOMIZATIONS, use these instructions upgrading and preserving customizations

### B. If you have NO CUSTOMIZATIONS (or don’t wish to preserve the ones you have), here’s a high-level overview/summary of a slightly shorter process:

1. Back up your site from the server as well as the copy on your computer.
2. Backup your database
3. Create a new directory and copy your site into it
4. Then create a new database and load your old database in it
5. Next, change the two configure.php files to utilize the new directory and database This way … when you attempt to upgrade you are “practicing” to see where the problems, if any will happen
6. Make sure all appears to be working on your temp site.
7. Now load the “new” version files to your new temp directory from latest downloaded ZIP
8. Run the http://www.YOURSITE.com/zc_install
9. Choose the Upgrade Database option
10. Process each suggested step one at a time … leave the first checkbox that the upgrader picked checked and uncheck the others.
    -Advantage is that you can see your problems step by step
    -Each time it completes it will recheck the boxes left to go.
    -Continue in this method until all boxes are unchecked.
11. If you find you have issues, you are not hurting anything and can always start over without damage to your existing shop and live database.

### QUESTION: “Why is this process so long?”

ANSWER: Another way to look at it is this: An “upgrade” is essentially a rebuilding of your site.
The steps outlined above are the recommended way to do it so that you rebuild your site in a temporary location, letting you resolve all potential problems before you ever touch your actual live site. This gives you time to sort out whatever needs sorting “just in case”, and allows you to keep taking sales while you’re preparing the upgrade. It also helps take some of the pressure off and makes it less urgent to do it all in one fell swoop.

The process of comparing your site against the original code for the old version is, in one sense, to simply help you quickly identify what customizations you need to make to put those same capabilities into your new site. It simply speeds the process and creates a sort of checklist of things for you to re-do on your new site.

Then, after you’ve got it all built in the temporary location, you put your live store down for maintenance, quickly redo the upgrade there, and then bring it online … meaning your actual live store’s downtime could be as short as 5-10 minutes depending on complexities etc.

So, follow the guide, and while there may be some learning involved and remembering of things you did awhile back, it’s all time well spent.

### QUESTION: “I have a very old version. Do I upgrade in stages, or all-at-once?”

ANSWER: You can upgrade to the latest version directly. When you do the database-upgrade step in zc_install it will show you all the database-version-levels which need upgrading, and will pre-check the checkboxes for you and will take care of upgrading through all those steps automatically. Usually you can just leave those boxes checked and put in the admin password and proceed with the upgrade, which normally will take just a few seconds.

# Help and Support

For additional help and support, visit the Zen Cart Documentation site and the Zen Cart Support Forum.

Zen Cart is derived from: Copyright 2003 osCommerce
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE
and is redistributable under Version 2 of the GNU General Public License.

This software is OSI Certified Open Source Software.
OSI Certified is a certification mark of the Open Source Initiative.

Copyright 2003 - 2020 Zen Ventures, LLC
Zen Cart
www.zen-cart.com