Server Requirements

👁 Sebastian G. Marinescu has updated this page 1 time
👁 Bochkarev Ivan has updated this page 7 times
👁 Mark Hamstra has updated this page 17 times

Last updated Feb 27th, 2023 | Page history | Improve this page | Report an issue

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$234 per month—let's make that $500!

Learn more

MODX will run fine on most shared/cloud hosting, as well as VPS and dedicated boxes. MODX is written in PHP, typically uses a MySQL database, and needs a webserver like Apache or nginx to serve web requests.

Component	Minimum	Recommended
PHP	7.2	7.4 or higher, 8 supported
Database	Latest MySQL 5.6.x	MariaDB 10.1.x or Percona Server 5.6.x or above
Webserver	*	NGINX 1.8 or Apache 2.4

PHP¶

MODX 3 requires at least PHP 7.2, but higher is recommended. PHP 8 is also supported.

The following extensions are required by MODX, or are commonly required by extras: zlib, json, gd, pdo (specifically pdo_mysql), imagick, simplexml (php-xml), curl, and mbstring. These are common extensions, and are usually enabled by default.

A memory_limit of at least 64M or higher is recommended.

Database¶

MODX supports a mysql database and a third-party postgres implementation is available. It is important to note that extras also need to implement different drivers for their custom database tables, which is often only done for mysql, making that your best bet.

Note: sqlsrv support is deprecated and has been removed in 3.0.

The minimum supported MySQL version is 4.1.20, but 5.7 or up is recommended. It is also possible to use clusters like Galera.

Prior to MODX3, sqlsrv was also supported. As that was practically unused, support for it has been removed in MODX 3.0.

Both MyISAM and InnoDB storage engines are supported, as are utf8 and utf8mb character sets. It is recommended to use a utf8mb character set for widest UTF-8 support.

The following permissions are required: SELECT, INSERT, UPDATE, DELETE for normal operations, CREATE, ALTER, INDEX, DROP for installations and upgrades of the core and installable extras, and CREATE TEMPORARY TABLES by some third party extras.

Web servers¶

MODX will run on most web servers available today. Apache 2.4+ or nginx 1.18.x are recommended.

In order to use friendly urls, you may need additional configuration depending on the web server. Instructions are available for apache, nginx and lighttpd.

Browser Support for the Manager¶

To use the back-end interface, the following desktop browsers are supported:

Edge (last 2)
Chrome (last 2)
Firefox (last 2)
Safari (last 2)

Supported mobile/tablet browsers:

Chrome for Android (last)
Safari on iOS (last)

The manager might work fine on older or different browsers, but they are not officially supported.