Media Backups
Media files associated with a WordPress environment can be viewed and downloaded in the application view of the VIP Dashboard.
Generated media file backups:
- are stored in Amazon S3 and retained for 7 days.
- are compressed into a single ZIP file with the file extension
*.zip
.
- can be imported to local development environments.
Prerequisites
- To view the Media Backups panel, a user must have at minimum an Org member role or an App write role for that application.
- To download a Media Backups file, a user must have at minimum an Org admin role or an App admin role for that application.
Limitations
- Only one media backup can be prepared at a time.
- Media backups for larger numbers of files will take a longer time to prepare.
- Only media backups for up to 3 TB of files can be downloaded.
- Only media backups with less than 2.5 million files can be downloaded.
- Up to 3 previously requested and available media backups are listed under “Available Backups”. Each previously requested backup will expire after 7 days and be removed from the list.
- Media backups are requested per environment. Each backup will include only the media files that were uploaded through WordPress, or imported via VIP-CLI to that specific environment.
- A production environment’s media files are made available for reference to non-production environments after a data sync. A media backup of a non-production environment will not include the media that is referenced from production.
- Media backups will not be available for a WordPress multisite environment if a site on the network is under maintenance mode, has a domain misconfiguration, or is inaccessible due to other configuration issues.
Download a media backup
WordPress single sites
- Navigate to the VIP Dashboard for an application.
- Select an environment from the environment dropdown located at the upper left of the VIP Dashboard.
- Select the “Data” panel option at the left.
- Select “Media Backups”.
- Select the “Generate Backup” button to request a backup.
A displayed progress bar and a numerical percentage indicator will track the status of completion for the creation of the backup file. - The message “Media backup generated” will display when the backup file is ready for download.
The newly created media backup file will appear at the top of the list under “Available Backups”. - Select the “Download” button to download the file to the user’s local machine.
The “Download” button will expire after 15 minutes. Downloads that are already in progress will continue after the button expires.
WordPress multisites
- Navigate to the VIP Dashboard for an application.
- Select an environment from the environment dropdown located at the upper left of the VIP Dashboard.
- Select the “Data” panel option at the left.
- Select “Media Backups”.
- Select the dropdown bar below “Select a network site to back up” to display the first ten network sites from the multisite.
- Select a site from the dropdown list.
- A site can also be found by typing the site’s network site ID or
home_url
into the search field as a search term. - To request a backup for all sites on the network, select the “All network sites ([ ])” option from the dropdown.
- A site can also be found by typing the site’s network site ID or
- Select the “Generate Backup” button to request a backup.
A displayed progress bar and a numerical percentage will indicate the status of completion for the creation of the backup file. - The message “Media backup generated” will display when the backup file is ready for download.
The newly created media backup file will appear at the top of the list under “Available Backups”. - Select the “Download” button to download the file to the user’s local machine.
The “Download” button will expire after 15 minutes. Downloads that are already in progress will continue after the button expires.