You are reading the documentation for version 2.2. Magento 2.3 is the latest version available. Ensure you are reading the documentation for your version of Magento.

Magento 2.2 technology stack requirements

Operating systems (Linux x86-64)

A Linux distribution such as RedHat Enterprise Linux (RHEL), CentOS, Ubuntu, Debian, and so on.

Memory requirement

Upgrading the Magento applications and extensions you obtain from Magento Marketplaces and other sources can require up to 2GB of RAM. If you are using a system with less than 2GB of RAM, we recommend you create a swap file; otherwise, your upgrade might fail.

Composer (latest stable version)

Composer is required for developers who wish to contribute to the Magento 2 codebase or anyone who wishes to develop Magento extensions.

Web servers

Database

MySQL 5.6, 5.7

Magento is also compatible with MySQL NDB Cluster 7.4.*, MariaDB 10.0, 10.1, 10.2, Percona 5.7, and other binary-compatible MySQL technologies.

Magento only uses MySQL features compatible with MariaDB. MariaDB may not be compatible with all MySQL features, however, so be sure to research compatibility issues before using a feature in your Magento module.

PHP

Supported PHP versions:

  • ~7.0.13

  • ~7.1.0

  • ~7.2.0

The Magento 2.2.10 patch enables support for PHP 7.2. Supported PHP versions for Magento 2.2.x are 7.2 and 7.1. PHP 7.0 is no longer supported.

Required PHP extensions

The PHP installation instructions include a step for installing these extensions.

  • lib-libxml

  • ext-ctype

  • ext-gd

  • ext-spl

  • ext-dom

  • ext-simplexml

  • ext-bcmath

  • ext-hash

  • ext-curl

  • ext-iconv

  • ext-intl

  • ext-xsl

  • ext-mbstring

  • ext-openssl

  • ext-zip

  • ext-pdo_mysql

  • ext-soap

PHP OPcache

We strongly recommend you verify that PHP OPcache is enabled for performance reasons. The OPcache is enabled in many PHP distributions. To verify if it is installed, see our PHP documentation.

If you must install it separately, see the PHP OPcache documentation.

PHP settings

We recommend particular PHP configuration settings, such as memory_limit, that can avoid common problems when using Magento.

For more information, see Required PHP settings.

SSL

Mail server

Mail Transfer Agent (MTA) or an SMTP server

Magento can use the following technologies

  • Redis version 3.2 (compatible with 2.4+ ) for page caching and session storage
  • Varnish version 4.x or 5.0
  • memcached latest stable version for session storage with either memcache or memcached PHP extensions (latest stable version)

Magento Commerce only

  • Elasticsearch

    Magento Commerce version 2.2.x supports the following Elasticsearch versions:

    • Elasticsearch 6.x

      Magento still provides support for but does not recommend Elasticsearch 2.x and 5.x.

      If you must run Elasticsearch 2.x or 5.x with Magento 2.2.8, you must change the Elasticsearch client version.

      Follow the instructions in Change Elasticsearch Client.

  • RabbitMQ 3.5.x (compatible with 2.0 and later)

    RabbitMQ can be used to publish messages to queue and to define the consumers that receive the messages asynchronously.

  • Three master databases

    These master databases provide scalability advantages for different functional areas of the Magento application, such as checkout, orders, and all remaining Magento2 application tables.

  • php_xdebug2.2.0> or later (development environments only; can have an adverse effect on performance)

There is a known issue with xdebug that can affect Magento installations or access to the storefront or Magento Admin after installation.

For details, see Known issues that affect installation.

  • PHPUnit (as a command-line tool) 6.2.0

Documentation

Install Magento prerequisites