Compatibility
Our tools are automatically tested against multiple PHP versions and run on various Linux distributions and macOS. Please note that Microsoft Windows is not fully supported, and some commands (e.g., db:dump, install) are unavailable on that platform.
Platform Compatibility
We recommend using the latest version of n98-magerun2 for the best support and most recent features.
| Platform & Version | Recommended n98-magerun2 Version |
|---|---|
| Adobe Commerce / Magento OS 2.4.9+ | v9.0.0 or later |
| Adobe Commerce / Magento OS 2.4.8+ | v9.0.0 or later |
| Mage-OS 1.2.x+ | v9.0.0 or later |
| Adobe Commerce / Magento OS 2.4.5 - 2.4.7 | v8.0.0 or later |
| Mage-OS 1.0.x - 1.1.x | v8.0.0 or later |
| Adobe Commerce / Magento OS 2.4.4 | v7.5.0 (last compatible) |
| Adobe Commerce / Magento OS 2.3.x | v5.2.0 (last compatible) |
| Adobe Commerce / Magento OS 2.2.x | v3.2.0 (last compatible) |
| Adobe Commerce / Magento OS 2.1.x | v3.2.0 (last compatible) |
| Adobe Commerce / Magento OS 2.0.x | v2.2.3 (last compatible) |
PHP Version Compatibility
| PHP Version | Required n98-magerun2 Version |
|---|---|
| PHP 8.5 | v9.0.0 or later |
| PHP 8.4 | v9.0.0 or later |
| PHP 8.3 | v8.0.0 or later |
| PHP 8.2 | v8.0.0 or later |
| PHP 8.1 | v9.5.1 (last compatible) |
| PHP 7.4 | v7.5.0 (last compatible) |
| PHP 7.3 | v6.1.1 (last compatible) |
| PHP 7.2 | v4.7.0 (last compatible) |
info
Starting with v10.0.0, PHP 8.2 is the minimum supported version. If you're on PHP 8.1 or lower, stay on the v9.x line.
For details on downloading specific historical releases, please see the installation guide.