Create Magento App
Create ScandiPWA AppScandiPWA DocsGitHub
v1
v1
  • Create Magento App
  • Getting started
    • Getting Started
    • Prerequisites
      • Linux requirements
      • MacOS requirements
        • Apple Silicon
      • Windows requirements
    • Available commands
      • Start the application
      • Stop the application
      • Check application status
      • Enter application CLI
      • Explore application logs
      • Execute commands in Docker containers
      • Link a theme
      • Import database dump
      • ⚠️ Uninstall a project
    • Folder structure
    • Updating to New Releases
      • Testing Alpha Releases
    • Configuration File
    • Supported Magento versions
    • How does it work?
    • Limitations
  • Usage guide
    • Using console commands
    • Accessing Docker containers
    • Linking a Scandi Theme
    • Enabling XDebug
    • Enabling SSL
    • Configuring PHP
    • Use custom domain
    • Access on the local network
    • Importing database
      • Importing remote database
    • Using Enterprise Edition
    • Converting legacy Docker setup to CMA
    • Improve Performance
  • Scripts Extensions
    • PHP Extensions
      • ionCube Extension
  • Troubleshooting
    • Common Issues
    • CMA Debugging
    • Uninstall CMA
Powered by GitBook
On this page
  • Using WSL
  • 1. Install WSL
  • 1.1 Install Windows Terminal (Optional)
  • 1.2 Install Visual Studio Code (Optional)
  • 2. Install Docker Desktop for Windows
  • 3. Enable WSL 2 integration in Docker Desktop settings
  • 4. Install platform-specific dependencies:
  • 5. Install PHPBrew
  • 6. Prepare the environment
  • 7. Start your application
  • Using VM
  1. Getting started
  2. Prerequisites

Windows requirements

PreviousApple SiliconNextAvailable commands

Last updated 2 years ago

Using WSL

Since magento-scripts@1.6.0

1. Install WSL

To install WSL2 on Windows follow .

For we recommend choosing the latest Ubuntu release, as it has the best compatibility on Windows.

1.1 Install Windows Terminal (Optional)

On Windows with WSL, it is recommended to use . By using it you can open different shells and access different WSL distros in the same place, which is quite handy.

1.2 Install Visual Studio Code (Optional)

VSCode has excellent integration with WSL, so you can run commands, edit code and debug it inside a single editor. .

2. Install Docker Desktop for Windows

3. Enable WSL 2 integration in Docker Desktop settings

Go to Docker Desktop settings > General and make sure that Use the WSL 2 based engine checkbox is checked.

Then, go to Resources >WSL Integration and enable WSL integration into your distro.

Toggle your distro and click Apply & Restart.

4. Install platform-specific dependencies:

Since magento-scripts 1.4.0 CMA will also check installed dependencies before starting the application, and if they are missing will provide instructions on how to install them!

apt-get install \
    libcurl4-openssl-dev \
    libonig-dev \
    libjpeg-dev \
    libjpeg8-dev \
    libjpeg-turbo8-dev \
    libpng-dev \
    libicu-dev \
    libfreetype6-dev \
    libzip-dev \
    libssl-dev \
    build-essential \
    libbz2-dev \
    libreadline-dev \
    libsqlite3-dev \
    libssl-dev \
    libxml2-dev \
    libxslt1-dev \
    libonig-dev \
    php-cli \
    php-bz2 \
    pkg-config \
    autoconf \
    libsodium-dev

5. Install PHPBrew

Since magento-scripts@1.7.0 this part will be done automatically.

# Download PHPBrew
curl -L -O https://github.com/phpbrew/phpbrew/releases/latest/download/phpbrew.phar

# Make it executable
chmod +x phpbrew.phar

# Move PHPBrew binary to system folder.
sudo mv phpbrew.phar /usr/local/bin/phpbrew

# Initialize PHPBrew
phpbrew init

6. Prepare the environment

To work with Magento you need access keys to access the Magento repository.

  1. Generate Access Keypair

Now you have a public key and private key values.

To use them you have 2 options:

  1. Use COMPOSER_AUTH environmental variable

    This option is used as a global variable on your machine.

    Replace <public key> and <private key> with your public and private key.

    export COMPOSER_AUTH='{
        "http-basic":{
            "repo.magento.com": {
                "username": "<public key>",
                "password": "<private key>"
            }
        }
    }'

    Add the result to your .bashrc or .zshrc and reload your terminal.

  2. Use auth.json file

    This option is used on a per-project basis, so your credentials will be always correct no matter which project you are working on.

    Create auth.json file in the root of your project and inside put the following content using the same <public key> and <private key> you obtained before:

    {
        "http-basic":{
            "repo.magento.com": {
                "username": "<public key>",
                "password": "<private key>"
            }
        }
    }

7. Start your application

Using VM

Download and install .

Full list of dependencies for each Linux distro available .

To install PHPBrew on Linux you will need to follow instructions or use the commands below:

Go to

Start command description can be found . To access Magento CLI, Composer and PHP use command.

As an option, you can run CMA on Windows using a Linux VM running in (free) or (paid). We recommend using or distros, although , and distros based on apt , pacman, yum, dnf package managers should also work. for this option is the same as installing on a common Linux platform.

Docker Desktop for Windows
installation
https://marketplace.magento.com/customer/accessKeys/
here
cli
Virtual Box
VMWare Workstation Player
Ubuntu
Fedora
Linux Mint
CentOS
Installation guide
this guide
step #6 Install your Linux distribution of choice
Windows Terminal
Developing in WSL
here