User Tools

Site Tools


How To Upgrade LiteCart

Upgrade from any previous master release version of LiteCart. The upgrade procedure will sort out and apply all necessary version patches.

1. Backup your files AND database!! Do not underestimate the damage that can be caused by a failed upgrade.

2. Upload the contents of the folder public_html/ to the corresponding path of your installation replacing the current files. Any modified files will be overwritten! If you have renamed your admin/ folder, make sure the files of the admin/ folder are uploaded to the right place.

3. (Option A) Point your browser to and follow the instructions on the page.

(Option B) Execute the CLI command php /var/www/path/to/litecart/install/upgrade.php

4. Make sure everything went fine and delete the install/ folder.

If there are complications after your installation, try switching to the default template and disable any vQmods. If you need help, turn to our forums at

Please note: Add-ons are version specific and might cause your upgraded platform to malfunction. Make sure all your add-ons are up to date.

Will My Add-ons and vQmods Stop Working?

Both yes, and no. Some will be affected, some not. It all depends on what changes were made to the new version of LiteCart. This is a perfectly natural cause from upgrading. If an add-on or modification stopped working it indicates that there most probably were changes made to LiteCart to improve the original feature, and for users' best experience. You should therefore make sure your add-ons are up to date and compatible with the new version.

We always recommend having a development platform for testing. The Add-ons Store has a great tool for transfering changes between the two platforms called Deploy Changes.

All application errors are logged in the ~/logs/errors.log file. When loading a page with errors, append ?debug to the URL and you should see extended information regarding the error.

See Also

how_to_upgrade.txt · Last modified: 2021/07/15 00:13 by