Magento 2.1.x technology stack requirements

Operating systems (Linux x86-64)

Linux distributions 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


MySQL 5.6

Magento application version 2.1.2 and later are compatible with MySQL 5.7.

MariaDB and Percona are compatible with Magento because we support MySQL 5.6 APIs.


7.0.0, 7.0.1 7.0.2 7.0.3 7.0.4 7.0.5 7.0.6–7.0.x 7.1.x
Not supported Supported Not supported Supported Not supported Supported (2.1.2 and later) Not supported
5.6.0–5.6.4 5.6.5–5.6.x
Not supported Supported

| 5.5.x | | Not supported |

PHP documentation: CentOS, Ubuntu

Required PHP extensions:

*	[json]({:target="_blank"}
*	[iconv]({:target="_blank"}

PHP OPcache

We strongly recommend you verify the 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 for CentOS or Ubuntu.

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.


Mail server

Mail Transfer Agent (MTA) or an SMTP server

RabbitMQ 3.5 (Only Magento Commerce)

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

Magento can utilize the following technologies:

  • Redis version 3.0 for page caching and session storage (the latter supported by Magento version 2.0.6 and later only)
  • Varnish version 3.5 or latest stable 4.x version for page caching
  • memcached latest stable version for session storage with either memcache or memcached PHP extensions (latest stable version)

  • Magento Commerce only

    • Apache Solr 4.x

      Solr search can be used as a search provider. Available for Magento Commerce only.

    • Elasticsearch versions 1.7 and 2.x (recommended)

      • If you get the Elasticsearch software from the Elasticsearch Linux repository, we support versions 2.x.
      • If you get the Elasticsearch software from their Elasticsearch-PHP repository, we support the 2.0 branch.
    • Three master databases

      These master databases provide scalability advantages for different functional areas of the Magento application: checkout, orders, and product data. Available for Magento Commerce only.

  • 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 issue with xdebug.

  • PHPUnit (as a command-line tool) 4.1 or later


Install Magento prerequisites