Configuring a mount mode

This document describes how to configure a mount mode.

Configuring mutagen mount mode on MacOS

To configure mutagen mount mode on MacOS:

1. Install or update Docker Desktop for Mac to the latest stable version.

2. Adjust the mount: section of deploy.local.yml as follows:

docker:
...
    mount:
        mutagen:
            platforms:
                 - macos

3. Bootstrap the Docker SDK:

docker/sdk boot

4. Follow the installation instructions displayed in the grey block of the output of the command you have run in the previous step.

5. Build and run Spryker application based on demo data:

docker/sdk up --build --data --assets

Configuring docker-sync mount mode on MacOS

To configure docker-sync mount mode on MacOS:

1. Install ruby and ruby-dev 2.7.0preview1 or higher:

sudo apt-get install ruby ruby-dev

2. Install Unison 2.51.2 or higher:

brew install unison

3. Install docker-sync 0.5.11 or higher:

sudo gem install docker-sync

4. Adjust the mount section of deploy.local.yml as follows:

docker:
...
   mount:
       docker-sync:
           platforms:
               - macos

5. Bootstrap the Docker SDK:

docker/sdk boot

6. Follow the installation instructions displayed in the grey block of the output of the command you have run in the previous step.

7. Build and run Spryker application based on demo data:

docker/sdk up --build --data --assets

Configuring a native mount mode on Linux

To configure a native mount mode on Linux:

1. Install or update Docker for Linux to the latest stable version.

2. Adjust the mount: section of deploy.local.yml as follows:

docker:
...
   mount:
       native:
           platforms:
               - linux

3. Bootstrap the Docker SDK:

docker/sdk boot

4. Follow the installation instructions displayed in the grey block of the output of the command you have run in the previous step.

5. Build and run Spryker application based on demo data:

docker/sdk up --build --data --assets

Configuring docker-sync mount mode on Windows with WSL1

To configure docker-sync mount mode on Windows with Windows Subsystem for Linux 1 (WSL1):

1. Install Docker Desktop Stable 2.3.0.2 or higher.

2. Enable WSL1.

3. In WSL, install the latest version of Docker:

   1. Update packages to the latest versions:

   sudo apt-get update
   

   2. Install the following packages to allow apt to access repositories via HTTPS:

   sudo apt-get install \
   apt-transport-https \
   ca-certificates \
   curl \
   gnupg-agent \
   software-properties-common
   

   3. Add Docker’s official GNU Privacy Guard key:

   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
   

   4. Set up a stable repository:

   sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"
   

   5. Install the latest version of Docker Community Edition:

   sudo apt-get install docker-ce docker-ce-cli containerd.io
   

4. Install Docker Compose:

   1. Check the latest stable release of Docker Compose.
   2. Download Docker Compose:
   Docker Compose version

   Replace {docker-compose-release} in the command parameter with the version you have selected in the previous step.

   sudo curl -L "https://github.com/docker/compose/releases/download/{docker-compose-release}/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
   

   3. Apply executable permissions to the binary:

   sudo chmod +x /usr/local/bin/docker-compose
   

5. Install docker-sync:

   1. Install ruby and ruby-dev:

   sudo apt-get install ruby ruby-dev
   

   2. Install docker-sync:

   sudo gem install docker-sync
   

6. Set your Docker for Windows host as an environment variable:

   1. In Docker for Windows settings, select Expose daemon on tcp://localhost:2375 without TLS.
   2. To update the profile with the environment variable, in your WSL shell, run the command:

   echo "export DOCKER_HOST=tcp://127.0.0.1:2375" >> ~/.bashrc
   

7. Compile and install OCaml:

   1. Install the build script:

   sudo apt-get install build-essential make
   

   2. Check the latest compatible OCaml release. In the next steps, replace {ocaml-version} in command parameters with the version you choose.
   3. Download the OCaml archive:

   wget http://caml.inria.fr/pub/distrib/ocaml-{ocaml-version}/ocaml-{ocaml-version}.tar.gz
   

   4. Extract the archive:

   tar xvf ocaml-{ocaml-version}.tar.gz
   

   5. Change the directory:

   cd ocaml-{ocaml-version}
   

   6. Configure and compile OCaml:

   ./configure
   make world
   make opt
   umask 022
   

   7. Install OCaml and clean:

   sudo make install
   sudo make clean
   

8. Compile and install Unison:

   1. Check the latest release of Unison. In the next steps, replace {unison-version} in command parameters with the version you choose.
   2. Download the Unison archive:

   wget https://github.com/bcpierce00/unison/archive/{unison-version}.tar.gz
   

   3. Extract the archive:

   tar xvf {unison-version}.tar.gz
   

   4. Change the directory:

   cd unison-{unison-version}
   

   5. Compile and install Unison:

   make UISTYLE=text
   sudo cp src/unison /usr/local/bin/unison
   sudo cp src/unison-fsmonitor /usr/local/bin/unison-fsmonitor
   

9. Adjust the mount: section of deploy.local.yml as follows:

docker:
...
   mount:
       docker-sync:
           platforms:
               - windows

10. Bootstrap the Docker SDK:

docker/sdk boot

11. Follow the installation instructions displayed in the grey block of the output of the command you have run in the previous step.

12. Build and run Spryker application based on demo data:

docker/sdk up --build --data --assets

Configuring native mount mode for Windows with WSL2

To configure native mount mode for Windows with Windows Subsystem for Linux 2 (WSL2):

1. Download and install Docker Desktop Stable 2.3.0.2 or higher.

2. Enable WSL2.

3. In WSL, install Docker:

   1. Update packages to the latest version:

   sudo apt-get update
   

   2. Install packages to allow apt to access repositories via HTTPS:

   sudo apt-get install \
   apt-transport-https \
   ca-certificates \
   curl \
   gnupg-agent \
   software-properties-common
   

   3. Add Docker’s official GNU Privacy Guard key:

   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
   

   4. Set up a stable repository:

   sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"
   

   5. Install the latest version of Docker Community Edition:

   sudo apt-get install docker-ce docker-ce-cli containerd.io
   

4. Install Docker Compose:

   1. Check the latest stable release of Docker Compose.
   2. Download Docker Compose:
   Docker Compose version

   Replace {docker-compose-release} in the command parameter with the version you have selected in the previous step.

   sudo curl -L "https://github.com/docker/compose/releases/download/{docker-compose-release}/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
   

   3. Apply executable permissions to the binary:

   sudo chmod +x /usr/local/bin/docker-compose
   

5. Bootstrap the Docker SDK:

docker/sdk boot

6. Follow the installation instructions displayed in the grey block of the output of the command you have run in the previous step.

7. Build and run Spryker application based on demo data.

docker/sdk up --build --data --assets