Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
178 lines (123 sloc) 7.44 KB
group title functional_areas
Magento 2.3 technology stack requirements

Operating systems (Linux x86-64)

Linux distributions, such as RedHat Enterprise Linux (RHEL), CentOS, Ubuntu, Debian, and similar. Magento is not supported on:

  • Windows OS
  • Mac OS

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]({{ page.baseurl }}/comp-mgr/trouble/cman/out-of-memory.html); 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

  • [Apache 2.4][]

    In addition, you must enable the Apache mod_rewrite and mod_version modules. The [mod_rewrite][] module enables the server to perform URL rewriting. The [mod_version][] module provides flexible version checking for different httpd versions. For more information, see [our Apache documentation][].

  • [nginx 1.x][]


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.


{} All 3rd party libraries now support PHP 7.2. If you are interested in participating in Magento Community projects we welcome your help! See our [ZenHub board][] for a full list of outstanding issues.

{% include install/ %}

Magento 2.3.1 is certified and tested on PHP 7.2.11. Magento 2.3.3 adds support for PHP 7.3.

Required PHP extensions

{} The [PHP installation instructions][] include a step for installing these extensions.

{% include install/ %}

Refer to [official PHP documentation][] for installation details.

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


  • A valid [security certificate][] is required for HTTPS.

  • Self-signed SSL certificates are not supported.

  • Transport Layer Security (TLS) requirement - PayPal and both require TLS 1.2 or later:

    • [More information about PayPal][]

Required system dependencies

Magento requires the following system tools for some of its operations:

Mail server

Mail Transfer Agent (MTA) or an SMTP server

Technologies Magento can use

  • [Redis][] versions 3.2, 4.0, 5.0 (compatible with 2.4+) for page caching and session storage. Version 5.0 is highly recommended.

  • Varnish version 4.x, 5.2 or 6.2

  • Elasticsearch

    {{}} version 2.3.x supports the following Elasticsearch versions:

    • Elasticsearch [6.x][]{:target="_blank"}

      Magento 2.3 uses [Elasticsearch PHP client][]{:target="_blank"} version 6.1.

      {} 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.3.1, you must change the Elasticsearch client version.

      Follow the instructions in [Change Elasticsearch Module][].

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

    [RabbitMQ][]{:target="_blank"} can be used to publish messages to queue and to define the consumers that receive the messages asynchronously.

{{}} only

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

Optional but recommended

  • php_xdebug 2.5.x{:target="_blank"} 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.

  • mcrypt{:target="_blank"} (for PHP < 7.2)
  • PHPUnit (as a command-line tool) 6.2.0

[Change Elasticsearch Module]: {{ page.baseurl }}/config-guide/elasticsearch/es-downgrade.html [Composer]: [Apache 2.4]: [mod_rewrite]: [mod_version]: [our Apache documentation]: {{page.baseurl}}/install-gde/prereq/apache.html [nginx 1.x]: [ZenHub board]:,116426364,115111902 [PHP installation instructions]: prereq/php-settings.html [official PHP documentation]: [PHP OPcache]: [PHP documentation]: prereq/php-settings.html [PHP OPcache documentation]: [Required PHP settings]: {{ page.baseurl }}/install-gde/prereq/php-settings.html [security certificate]: [More information about PayPal]: {{page.baseurl}}/install-gde/system-requirements_tls1-2.html [Redis]: {{page.baseurl}}/config-guide/redis/config-redis.html [Varnish]: {{page.baseurl}}/config-guide/varnish/config-varnish.html [Elasticsearch]: {{page.baseurl}}/config-guide/elasticsearch/es-overview.html [6.x]: [Elasticsearch PHP client]: [2.x and 5.x]: [RabbitMQ]: {{page.baseurl}}/config-guide/mq/rabbitmq-overview.html

You can’t perform that action at this time.