Linux requirements

1. 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!

Ubuntu
Linux Mint
CentOS
Fedora
Arch Linux
Ubuntu
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
Linux Mint
apt-get install \
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 \
libcurl4-openssl-dev \
libsodium-dev
CentOS
yum install --enablerepo=PowerTools \
openssl-devel \
libjpeg-turbo-devel \
libpng-devel \
gd-devel \
libicu \
libicu-devel \
libzip-devel \
libtool-ltdl-devel \
oniguruma-devel \
libsodium \
libsodium-devel
Fedora
yum install openssl-devel \
libjpeg-turbo-devel \
libpng-devel \
gd-devel \
libicu \
libicu-devel \
libzip-devel \
libtool-ltdl-devel \
oniguruma-devel \
libsodium \
libsodium-devel
Arch Linux
pacman -S freetype2 \
openssl \
oniguruma \
libxslt \
bzip2 \
libjpeg-turbo \
libpng \
icu \
libxml2 \
autoconf \
libzip \
sqlite \
readline \
perl \
libsodium

2. Install Docker

You can follow the official installation guide from Docker or use commands below:

# Download installation script
curl -fsSL https://get.docker.com -o get-docker.sh
# Run installation script
sudo bash get-docker.sh
# Add your user to the “docker” group to run docker without root.
sudo usermod -aG docker $USER
# After that you'll need to logout and login to your account or,
# you can temporarily enable group changes by running command below
newgrp docker

3. Install PHPBrew

Since [email protected] this part will be done automatically.

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

# 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

4. Prepare the environment

4.1 Use auth.json

Some projects have different authentication keys for repositories, so you can use auth.json file in the root of your project and put credentials inside this file. CMA will handle everything from here.

Learn more about composer authentication per project here.

4.2 Use COMPOSER_AUTH environmental variable

COMPOSER_AUTH is an environment variable that is used to authenticate your Magento project on Magento Composer Repository which contains Magento dependencies. To obtain it:

  1. Go to https://marketplace.magento.com/customer/accessKeys/

    NOTE: you have to be authorized.

  2. Generate Access Key pair.

  3. 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>"
    }
    }
    }'
  4. Add result from steps above to your .bashrc or .zshrc.

  5. Reload terminal.

5. Start your application

Start command description can be found here.