| Announced on | Rollout on |
| February 2, 2026 | February 5, 2026 |
Automatic log rotation will be introduced for error logs in MODX Cloud to help manage disk usage more efficiently as part of our ongoing platform improvements.
This change applies to all MODX Cloud platforms.
Error logs in the /log/ directory and www/core/cache/logs/ directory will now be automatically rotated to prevent unlimited growth. Previously, these logs could grow indefinitely, consuming disk space that counts toward your plan's storage quota.
What is changing
Starting February 5, 2026, error logs will be automatically rotated based on age and size limits.
How log rotation works:
- Individual log files are rotated when they reach 50MB in size
- Up to 4 rotated (archived) versions of each log are kept in the same directory
- Any logs older than 14 days are automatically deleted
- Maximum storage per log file: approximately 250MB (current log plus 4 archived versions)
- Rotated logs are renamed with numeric suffixes (e.g.,
error.log.1,error.log.2)
This rotation applies to:
- Site logs in
/log/ - MODX error logs in
www/core/cache/logs/ - Any custom error logs written to these directories
Access logs are not affected. Access logs will continue to be stored for security and traffic analysis purposes.
Who is affected
This change affects all MODX Cloud customers.
If you have custom error logs written to /log/ or www/core/cache/logs/ that you need to retain indefinitely, you will need to write those logs to a different location.
Why we're making this change
Error logs that accumulate over time can significantly increase disk usage. Since disk usage now counts toward plan quotas and may result in overage charges or require plan upgrades, automatic rotation ensures that customers with sites generating substantial error logs are not forced to manually manage log files or upgrade their storage tier for data that has little value after a few days.
Error logs are typically only useful for recent troubleshooting and rarely need retention beyond a short period. We determined that 14 days provides sufficient time for debugging while keeping disk usage manageable.
What you should do now
For most customers: No action is required. Automatic log rotation will be applied to your cloud.
If you need indefinite log retention: Move your custom error logs to a directory outside of /log/ and www/core/cache/logs/. You can create a custom directory anywhere in your cloud except within /www/ (your public site directory). Examples include /errors/ or /logs/.
Note: Log rotation settings are not configurable and will apply uniformly across all public MODX Cloud platforms.
If you have questions about this change or need assistance with custom logging configurations, please contact support.