Installation Guide

To set up your environment, install the following prerequisites:

• Git
• VirtualBox 5.2.2+
• Vagrant 2.0.0+
• vagrant-vbguest and vagrant-hostmanager plugins:

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

Run the following commands in your favorite shell (e.g. Bash):

1. Create the folder in which you want the source code to be placed:

mkdir devvm
cd devvm						

2. Initialize the Vagrant environment:

vagrant init devvm2.1.0 https://github.com/spryker/devvm/releases/download/v2.1.0/spryker-devvm.box

3. Update the Vagrantfile:

Add hostmanager plugin configuration:

mv Vagrantfile Vagrantfile.bak
awk '/^end/{print "  config.hostmanager.enabled = true\n  config.hostmanager.manage_host = true"}1' Vagrantfile.bak > Vagrantfile

4. Build and start the virtual machine:

VM_PROJECT=suite SPRYKER_REPOSITORY="git@github.com:spryker-shop/suite.git" vagrant up

When the VM is built and running, your local copy of the repository will be placed in the project subfolder of the folder where the VM is located (e.g. ~/devvm/project). The subfolder will be mounted inside the VM to /data/shop/development/current.

1. Log into the VM:

vagrant ssh

2. Install the Prestissimo Composer Tool:

To speed up the installation and update processes, it is recommended to install the Prestissimo Composer Tool. It will speed up the execution of the composer install and composer update commands both for local development and in server deployments. To do so, run:

composer global require hirak/prestissimo

3. Run the installation commands:

ulimit -n 65535
composer install
vendor/bin/install

Executing these steps will install all required dependencies, and run the installation process. Also, this will install the demo data and export it to Redis and Elasticsearch.

When the installation process is complete, Spryker Commerce OS is ready to use. It can be accessed via the following links:

• http://www.de.suite.local - front-end;
• http://zed.de.suite.local - backend (administrator interface).

Credentials to access the administrator interface: user admin@spryker.com and password change123.