System Requirements

This guide outlines the technical requirements for running Mage-OS in development and production environments. Verify your server meets these specifications before beginning installation.

Quick Reference (Mage-OS 2.0)

Minimum versions are the oldest supported. Recommended versions provide optimal performance and security.

Operating System

Production (Linux Only)

Development

• macOS: 13+ (Ventura or later)
• Windows: Windows 10/11 via WSL2

Production deployments require Linux. macOS and Windows are suitable for local development only.

Web Server

Apache

nginx

Choose one web server. nginx generally offers better performance at scale, while Apache provides easier configuration via .htaccess files.

PHP Requirements

Supported Versions

Required Extensions

bcmath, ctype, curl, dom, fileinfo, gd, hash, iconv, intl,
json, libxml, mbstring, openssl, pcre, pdo_mysql, simplexml,
soap, sockets, sodium, xml, xsl, zip, zlib

Verify extensions with: php -m | grep -i <extension_name>

Database

Supported Databases

Choose one database server. MariaDB and MySQL are the most common choices for Mage-OS deployments.

Database Settings

Recommended my.cnf or my.ini configuration:

[mysqld]
# Buffer pool: Set to 50-70% of available RAM for dedicated DB servers
innodb_buffer_pool_size = 1G

# Log file size: Larger values improve write performance
innodb_log_file_size = 256M

# Packet size: Required for large imports
max_allowed_packet = 64M

# Temp tables: Prevents disk-based temp tables for most queries
tmp_table_size = 64M
max_heap_table_size = 64M

# Connection settings
max_connections = 150
wait_timeout = 28800

For production servers with 8GB+ RAM, increase innodb_buffer_pool_size to 4G or higher.

Search Engine

A search engine is required for Mage-OS. It powers catalog search, layered navigation, and admin grids.

Supported Search Engines

OpenSearch is recommended for new installations as it is fully open source and actively maintained by the community.

Memory Requirements

Set heap size via ES_JAVA_OPTS or OPENSEARCH_JAVA_OPTS:

export OPENSEARCH_JAVA_OPTS="-Xms4g -Xmx4g"

Cache and Sessions

Redis / Valkey (Recommended)

Redis or Valkey provides high-performance caching for sessions, page cache, and the application cache backend.

Valkey is recommended for new installations as an open source Redis alternative.

Varnish (Production)

Varnish is a full-page cache that dramatically improves frontend performance. While optional for development, it is recommended for production.

Message Queue

RabbitMQ (Optional)

RabbitMQ enables asynchronous processing of bulk operations, inventory updates, and order processing. It is optional for small stores but recommended for high-traffic sites.

Composer

Composer is required for installing and updating Mage-OS.

Verify your version with: composer --version

Disk Space

Use SSD storage for optimal performance. NVMe drives provide the best results for database and search engine workloads.

Server Hardware

Minimum Requirements

These are baseline requirements. Actual needs depend on catalog size, traffic volume, and customizations.

Compatibility Matrix

Recommended Hosting Environments

Managed Magento Hosting

These providers offer pre-configured environments optimized for Mage-OS and Magento:

@TODO: Cover, or not? Providers vary greatly by region, quality, price

Cloud Providers (Self-Managed)

For teams with DevOps expertise, these cloud providers offer flexible infrastructure:

Development Environments

Docker-based local development environments provide consistent, reproducible setups:

All tools support Mage-OS out of the box with minimal configuration.

Next Steps

Ready to install Mage-OS? Follow these guides:

• Quick Start Guide - Install Mage-OS in 30 minutes
• Installation Guide - Detailed installation instructions
• Migration Guide - Switch from Magento Open Source
• Releases - Download the latest version