Troubleshoot backups
A backup can fail for any of the following reasons:
Backup disabled
If the Magento backup functionality does not start or displays the following message, you need to enable the feature prior to backing up.
1
2
Backup functionality is disabled.
Backup functionality is currently disabled. Please use other means for backups.
Enter the following CLI command:
1
bin/magento config:set system/backup/functionality_enabled 1
For additional information on backups, see Back up and roll back the file system, media, and database.
Insufficient disk space
If the backup failed because of insufficient disk space, you should typically free up disk space by moving some files to another storage device or drive. However, there might be other ways to resolve the issue. See one of the following resources for tips:
- 8 Tips to Solve Linux & Unix Systems Hard Disk Problems Like Disk Full Or Can’t Write to the Disk
- serverfault: df says disk is full, but it is not
- unix.stackexchange.com: Tracking down where disk space has gone on Linux?
Operating system error
Unfortunately, we can’t recommend anything specific because of the variety of errors you might encounter. We can suggest, however, you:
- Contact your system administrator
- Search public forums like Stack Exchange or Stack Overflow
- Open a GitHub issue and we’ll try to help
Backup fails
If the backup fails or if all backup tests fail, it’s possible the Magento file system owner doesn’t have sufficient privileges and ownership of the Magento file system. For example, another user might own the files or the files might be read-only.
Pay particular attention to file system permissions and ownership of the <magento_root>/var directory and subdirectories. For more information, see Set file system permissions and ownership
