Installing

Installing Commerce to contribute back? Check out our Getting ready for development guide.

Requirements

Commerce 2.x requires Drupal 8.3.0 or newer.

If you already have a web server, make sure it satisfies Drupal 8’s requirements. The recommended memory limit is 256MB or more. For local development we recommend Drupal VM (advanced users) or Acquia Dev Desktop (beginners). You will also need Composer.

Why must we use Composer?

PHP requirements

Drupal Commerce requires that you have the bcmath extension installed.

If you are using DrupalVM, add the following to your configuration.

extra_packages:
  - php-bcmath

New site

The following command will download Drupal 8 + Commerce 2.x with all dependencies to the mystore folder:

composer create-project drupalcommerce/project-base mystore --stability dev

Install it just like a regular Drupal site. Commerce will be automatically enabled for you.

Tips:

  • The bin folder contains Drupal Console binary.
  • The web folder represents the document root.
  • Composer commands are always run from the site root (mystore in this case).
  • Downloading additional modules: composer require "drupal/devel:1.x-dev"
  • Updating an existing module: composer update drupal/address -–with-dependencies

See the project-base README_ for more details.

Existing site

Run these commands in the root of your website:

Download Commerce

This will also download the required libraries and modules (Address, Entity, State Machine, Inline Entity Form, Profile).

cd /path/to/drupal8
composer require "drupal/commerce"

Enable Commerce

The instructions below use Drupal Console

drupal module:install commerce_product commerce_checkout commerce_cart

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