Installing in Development mode on MacOS and Linux
Edit on GitHubStarting with the 202204.0 release, the following guide applies to both Intel and ARM architectures. You can install the demo shops of previous versions on ARM chips by following the steps from the Switch to ARM architecture technical enhancement guide.
This document describes how to install Spryker in Development Mode on MacOS and Linux.
Install Docker prerequisites on MacOS and Linux
To install Docker prerequisites, follow one of the guides:
Clone a Demo Shop and the Docker SDK
-
Open a terminal.
-
Create a new folder and navigate into it.
-
Depending on the desired Demo Shop:
- Clone the B2C repository:
git clone https://github.com/spryker-shop/b2c-demo-shop.git -b 202212.0-p2 --single-branch ./b2c-demo-shop
- Clone the B2B repository:
git clone https://github.com/spryker-shop/b2b-demo-shop.git -b 202212.0-p2 --single-branch ./b2b-demo-shop
-
Depending on the repository you’ve cloned, navigate into the cloned folder:
- B2C repository:
cd b2c-demo-shop
- B2B repository:
cd b2b-demo-shop
Make sure that you are in the correct folder by running the pwd
command.
- Clone the Docker SDK repository:
git clone https://github.com/spryker/docker-sdk.git --single-branch docker
Configure and start the instance
- Bootstrap local docker setup:
docker/sdk bootstrap deploy.dev.yml
Once you finish the setup, you don’t need to run bootstrap
to start the instance. You only need to run it after you update the Docker SDK or the deploy file.
- Update the
hosts
file:
Follow the installation instructions in the white box from the docker/sdk bootstrap
command execution results to prepare the environment.
You can run docker/sdk install
after bootstrap
to get the list of the instructions.
- Once the job finishes, build and start the instance:
docker/sdk up
Depending on the hardware performance, the first project launch can take up to 20 minutes.
Endpoints
To ensure that the installation is successful, make sure you can access the configured endpoints from the Deploy file. For more information about the Deploy file, see Deploy file reference - 1.0.
Back-Office
The default credentials to access the back-office are located inside this file /src/Pyz/Zed/User/UserConfig.php
RabbitMQ
To access RabbitMQ UI, use spryker
as a username and secret
as a password. You can adjust the credentials in deploy.yml
. See Deploy file reference - 1.0 to learn about the Deploy file.
Getting the list of useful commands
To get the full and up-to-date list of commands, run docker/sdk help
.
Next steps
Thank you!
For submitting the form