Installing with Commerce Kickstart 1.x

 NOTICE:  This installation instruction page deals with Commerce Kickstart version 1.x. The first version of Kickstart is a developers "blank slate" that includes just the bare minimum to get a store up and running. The second version of Kickstart includes a developers "template" that includes 80+ contributed modules setup as a fully functioning store. Installing Commerce Kickstart 2.

Commerce Kickstart is an installation profile designed to get you up and running quickly with Drupal Commerce. It duplicates a standard Drupal installation and provides additional configuration for Commerce modules and components. It is freely available through the Commerce Kickstart project page.

Commerce Kickstart Basics

Simple Installation

Installing Commerce Kickstart is as easy as installing Drupal itself, and in most cases is exactly the same procedure. Commerce Kickstart is just a copy of Drupal which includes the required modules and an install profile which does some sane initial setup for you.

  1. Download the installation package from the project page (For example, the tar.gz or zip file).
  2. Uncompress it into a directory where your webserver can find it. There are many ways to do this in many environments, but let's assume your webserver is looking for http://localhost in the /var/www directory. In that case, copy all the files (including the .htaccess, which may be hidden) into /var/www.
  3. Point your browser at root of the site you have set up. We'll assume it's http://localhost.
  4. Follow the instructions, choosing the "Commerce Kickstart" installation profile.

When you've completed this basic process, you have a Commerce install with the required modules in Drupal's profiles/commerce_kickstart/modules directory.

Alternatives, Recipes, and Issues

You have many options as an advanced sitebuilder:

  • This is considered bad practice. Move modules into sites/all/modules or sites/all/modules/contrib: Although installation profiles build with the modules in the profiles directory, many developers want them in sites/all/modules. Before running the installation process, just move the modules from profiles/commerce_kickstart/modules into sites/all/modules with any tool you like. For example, mv profiles/commerce_kickstart/modules/* sites/all/modules/.
  • Add Commerce Kickstart to an existing Drupal codebase: Visit the releases page, find your release, and download the -no-core.tar.gz or -no-core.zip version of commerce_kickstart and uncompress it into profiles/commerce_kickstart OR drush dl commerce_kickstart. Either of these will include the required modules.
  • Updating the PHP memory limit if necessary: Commerce Kickstart installation involves the installation of 3 major contributed modules all at once on top of Drupal 7 itself, which may cause you to hit your memory limit during installation. If this happens, installation fails, and you will need to drop all tables from your database and reinstall with a higher memory limit (recommended 96M or higher to be safe; decrease as needed afterward).

Resources

Installing Commerce Kickstart requires no more knowledge than just installing Drupal, but depending on your starting point, that may seem like a lot. Here are some resources about installing Drupal:

Found errors? Think you can improve this documentation? edit this page