Installing Spryker with DevVM on MacOS and Linux

Edit on GitHub

We will soon deprecate the DevVM and stop supporting it. Therefore, we highly recommend installing Spryker with Docker.

To install the B2B Demo Shop or B2C Demo Shop on MacOS or Linux with DevVM, follow the steps below.

1. Install prerequisites

To set up your environment, do the following.

  1. Install the following prerequisites:

  2. Install vagrant-vbguest and vagrant-hostmanager plugins:

vagrant plugin install vagrant-vbguest &&
vagrant plugin install vagrant-hostmanager

2. Install DevVM

  1. Create a folder for the DevVM:
mkdir devvm
  1. Navigate to the folder you’ve created:
cd devvm				
  1. Initialize the Vagrant environment:
vagrant init devv410

For Spryker Core version 201907.0 or prior, initialize an older version of DevVM:

vagrant init devvm2.3.1
  1. Add hostmanager plugin configuration to the Vagrantfile:
mv Vagrantfile Vagrantfile.bak &&
awk '/^end/{print "  config.hostmanager.enabled = true\n  config.hostmanager.manage_host = true"}1' Vagrantfile.bak > Vagrantfile
  1. Build and start the DevVM with the needed Demo Shop:

    • With B2B Demo Shop:
    VM_PROJECT=b2b-demo-shop SPRYKER_REPOSITORY="" vagrant up
    • With B2C Demo Shop:
    VM_PROJECT=b2c-demo-shop SPRYKER_REPOSITORY="" vagrant up

This builds and runs the DevVM, and copies the repository to the project subfolder of the DevVM (e.g. ~/devvm/project). The subfolder is mounted inside the DevVM to /data/shop/development/current.

3. Install the shop

  1. Log into the DevVM:
vagrant ssh
  1. DevVM version below 2.2.0: Set the maximum number of connections to 65535:
ulimit -n 65535
  1. Install the Demo Shop:
composer install &&

This installs all required dependencies, and runs the installation process. Also, this installs demo data and exports it to Redis and Elasticsearch.

When the installation process is complete, you can access your Spryker Commerce OS via the following links:

  • B2B Demo Shop:

    • http://de.b2b-demo-shop.local - frontend (Storefront)
    • - backend (the Back Office)
    • - REST API (Glue)
  • B2C Demo Shop:

    • http://de.b2c-demo-shop.local/ - frontend (Storefront)
    • - backend (the Back Office)
    • - REST API (Glue)

Back Office credentials:

  • EMAIL:
  • PASSWORD: change123

Next steps