System Requirements
Complete technical requirements for running Mage-OS in development and production environments. Verify your server meets these specifications before beginning installation.
Quick Reference
Essential components for Mage-OS 2.1 at a glance
PHP
Min: 8.3 | Rec: 8.4
Composer
Min: 2.7 | Rec: 2.9
OpenSearch
Min: 2.5 | Rec: 2.19
MySQL / MariaDB
Min: 8.0 / 10.6 | Rec: 8.4 / 11.4
Redis / Valkey
Min: 7.0 | Rec: Valkey 8
RabbitMQ
Min: 3.12 | Rec: 4.0
Varnish
Min: 7.x | Rec: 7.6
Web Server
Apache 2.4+ or nginx 1.24+ (1.26 rec)
Minimum versions are the oldest supported. Recommended versions provide optimal performance and security.
Operating System
Supported platforms for development and production
Production (Linux Only)
| Distribution | Min Version |
|---|---|
| Ubuntu LTS | 22.04 Recommended |
| Debian | 12 Supported |
| Rocky Linux | 9 Supported |
| AlmaLinux | 9 Supported |
Development
- macOS: 13+ (Ventura or later)
- Windows: 10/11 via WSL2
For consistent environments, we recommend Docker-based tools like DDEV, Warden, or docker-magento.
Web Server
Choose Apache or nginx based on your needs
Apache
| Version | 2.4+ Supported |
| Required Modules | mod_rewrite |
| Configuration | .htaccess support enabled |
Easier configuration via .htaccess files.
nginx
| Version | 1.24+ 1.24 1.26 |
| Configuration | Custom rewrite rules required |
Better performance at scale for high-traffic stores.
PHP Requirements
Supported versions and required extensions
Supported Versions
Required Extensions
bcmathctypecurldomfileinfogdhashiconvintljsonlibxmlmbstringopensslpcrepdo_mysqlsimplexmlsoapsocketssodiumxmlxslzipzlibVerify extensions with: php -m | grep -i <extension_name>
Database
MySQL, MariaDB, or Percona Server
| Database | Minimum | Recommended | Notes |
|---|---|---|---|
| MySQL | 8.0 Minimum | 8.4 Recommended | Oracle's official distribution |
| MariaDB | 10.6 Minimum | 11.4 Recommended | Popular MySQL alternative |
| Percona | 8.0 Minimum | 8.0 Supported | Enterprise MySQL variant |
Search Engine
Required for catalog search and layered navigation
OpenSearch
RecommendedOpen source, community-maintained fork. Recommended for new installations.
Elasticsearch
SupportedRequires license for some features. Legacy option.
Memory Requirements
| Environment | Heap Size | Notes |
|---|---|---|
| Development | 1GB | Suitable for small catalogs |
| Staging | 2GB | Mirrors production |
| Production | 4GB+ | Scale based on catalog size |
Cache and Sessions
Redis, Valkey, and Varnish for optimal performance
Redis / Valkey
High-performance caching for sessions, page cache, and application cache.
| Valkey | 7.0+ 8.0 |
| Redis | 7.0+ 7.2+ |
Valkey is recommended as an open source Redis alternative.
Varnish (Production)
Full-page cache for dramatically improved frontend performance.
| Version | 7.x 7.6 |
Optional for development, but highly recommended for production stores.
Message Queue
Asynchronous processing for bulk operations
RabbitMQ
(Optional)Enables asynchronous processing of bulk operations, inventory updates, and order processing. Optional for small stores but recommended for high-traffic sites.
Server Hardware
Minimum and recommended specifications
| Resource | Development | Production (Small) | Production (Large) |
|---|---|---|---|
| CPU | 2 cores | 4 cores | 8+ cores |
| RAM | 4GB | 8GB | 16GB+ |
| Storage | 30GB SSD | 50GB SSD | 100GB+ NVMe |
Disk Space Breakdown
| Purpose | Minimum | Recommended | Notes |
|---|---|---|---|
| Application | 5GB | 10GB | Includes vendor directory |
| Database | 10GB | 50GB+ | Scales with catalog and orders |
| Media files | Varies | Varies | Product images, PDFs, downloads |
| Logs | 5GB | 10GB | Rotate logs to manage disk usage |
| Total Server | 30GB | 80GB+ | SSD storage recommended |
Compatibility Matrix
Mage-OS version requirements at a glance
| Mage-OS | PHP | MySQL | OpenSearch | Magento Base | Release |
|---|---|---|---|---|---|
| 2.1 Recommended | 8.3-8.4 | 8.0+ | 2.5+ | 2.4.8-p3 | January 2026 |
| 1.3 | 8.2-8.3 | 8.0+ | 2.5+ | 2.4.8-p2 | August 2025 |
| 1.2 | 8.2-8.3 | 8.0+ | 2.5+ | 2.4.8-p1 | June 2025 |
| 1.1 | 8.1-8.2 | 8.0+ | 2.5+ | 2.4.8 | April 2025 |
For the latest version information, see the Releases page.
Recommended Hosting & Development
Options for production hosting and local development
Managed Magento Hosting
For production stores, managed Magento hosting is strongly recommended. These specialized providers offer pre-configured environments optimized for Mage-OS and Magento.
- Regional availability near your customers
- Proven Mage-OS/Magento expertise
- Strong community reputation
- Uptime SLAs that meet your needs
Development Environments
Docker-based local development environments provide consistent, reproducible setups:
Next Steps
Ready to install Mage-OS?
