Magento 2.2.x 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

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) Supported (2.1.2 and later)

Required PHP extensions

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

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

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 5.x
    • Elasticsearch 2.x

    Magento 2.2.3 uses Elasticsearch PHP client version 5.1. Before version 2.2.3, Magento used PHP client version 2.0.

  • 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