Announced on | Rollout on |
April 17, 2025 | April 17, 2025 |
Starting on [Date] MODX
This announcement includes the following topics:
What is changing?
MODX Cloud has introduced the .backupinclude
file feature that gives you greater control over what additional files and directories from your home directory are included in your site backups. This enhancement allows you to preserve important files beyond the standard backup contents.
Why is MODX making this change?
By default, MODX Cloud backups only contain website files in the www/ directory and a database dump (.sql file). Many users have requested the ability to include additional files from their home directory in backups. The .backupinclude
file provides a simple solution to ensure critical files outside the www/
directory are preserved during the backup process.
What do I need to do?
To take advantage of this feature:
- Create a
.backupinclude
file in your site's home directory at/paas/[site-code]/home/.backupinclude
- Add one path per line, relative to your home directory
- Include trailing slashes (/) for directories
- Use comments (lines starting with #) to document your choices
Read the complete article on Extending Backups to Your Home Directory with .backupinclude for complete details.
If you have feedback or questions related to this announcement, contact MODX Customer Support.