From iThemes Codex
Revision as of 02:06, 11 April 2013 by Dustin (talk | contribs)
Jump to: navigation, search


Training Videos

For video training including walkthroughs & tutorials please see

Installing BackupBuddy

Check out the Installing BackupBuddy section to see how BackupBuddy can be uploaded and activated on Single sites or Multisite networks or Multisite sites.

Getting Started

Check out the Getting Started page to backup your Single sites or Multisite networks.

Restore or Migrate

Learn to Restore or Migrate your Single sites or Multisite networks with the latest importbuddy.php.

Settings Explained

Get in depth information about the various Settings.

Developing Locally

See the Develop Sites Locally page for developing WordPress sites locally on your own computer using something like XAMPP or MAMP. You can then migrate them to your web host.

Using your HOSTS file for seamless migrations

Here's one tutorial that may help:

The HOSTS file allows you to basically just update the DNS settings for the site ONLY FOR YOU on your computer. This lets you try out what would happen if you updated the DNS settings for everyone but only locally. The goal is basically to make your own computer think that your website is reached by going to the new IP address instead of the IP address everyone else on the internet goes to by visiting your URL. This allows you to access the new site before officially pointing everyone on the internet to the new server.

The procedure is basically:

  • Update your computer's HOSTS file to point the new destination server IP address. Leave DNS settings as-is so that everyone else online will continue to see the normal site.
  • Connect to your site. When you connect to it you should end up on the new server if you've set up your HOSTS file properly. Upload ImportBuddy, your backup file, etc to it.
  • Restore normally. Verify that it all works properly.
  • Assuming everything is good to go you can then change the DNS so that everyone else online gets switched over to accessing the new server. This results in a seamless launch with no down-time. Make sure to re-edit your HOSTS file to remove the bypass so you don't forget.


Server configuration is a very complex topic and varies wildly between hosts, server operating systems, and even the personal preference of the server administrator. Below are the bare minimum requirements for the plugin along with the recommended setup to get the most out of this plugin. You may use ServerBuddy to help you determine how your server compares to our minimum requirements & recommendations.

Server Recommendations (full functionality)

  • PHP 5.2+
  • mySQL 5.x+
  • WordPress 3.3+
  • Write permissions to /wp-content/uploads/ for the user running BackupBuddy.
    • Backups will be stored in /wp-content/uploads/backupbuddy_backups/
    • Temporary files will be stored in /wp-content/uploads/backupbuddy_temp/xxxxxxx/ (temporarily generated at each backup)
  • Free disk space equal to or greater than the entire size of your site once compressed.
    • SuPHP or environment so that file operations/zip run as user to prevent permissions issues.
    • PHP exec() function enabled
    • PHP ZipArchive class installed
  • Linux (Apache):
    • Command-line zip installed and accessible via exec().
  • Windows (only supported for local development via Apache; IIS is not officially supported):
    • Windows zip executable (available here)
      • You must have the ability to configure your server to allow execution of this zip.exe file for it to function.
      • File permissions must also be set to allow access and execution of the zip executable.
  • wp-config.php file must be in WordPress installation directory OR (starting with BackupBuddy v3.0) in the parent directory.

Minimum Server Requirements (reduced functionality)

NOTE: Some features of BackupBuddy will be unavailable or limited if running on minimum requirements without recommendations. Large sites may not be able to be backed up with these minimum features.'

  • PHP 5.2+
  • mySQL 5.x+
  • WordPress 3.2+
    • We are trying to maintain bare minimum backup functionality for legacy versions as far back as WordPress v2.6 (though it's not pretty nor guaranteed to work perfectly at this time; we recommend only performing backups & direct restores for older versions and use it for safety while upgrading to the latest WordPress).
  • Write permissions to /wp-content/uploads/ for the user running BackupBuddy.
  • BackupBuddy requires the uploads directory to be in the standard WordPress location.
    • Backups will be stored in /wp-content/uploads/backupbuddy_backups/
    • Temporary files will be stored in /wp-content/uploads/backupbuddy_temp/xxxxxxx/ (temporarily generated at each backup)
  • Free disk space equal to or greater than the entire size of your site once compressed.
  • wp-config.php file must be in WordPress installation directory OR (starting with BackupBuddy v3.0) in the parent directory.

Host Compatibility

Compare various Hosts & Hosting Environments to see how your host/potential host compares.

Misc. Information

Find out some Miscellaneous Information about BackupBuddy.


Frequently Seen Support Issues

Problems? We have compiled a list of issues and solutions to many problems that we have seen encountered before. Frequently Seen Support Issues to attempt to narrow down your problem and find a solution.

BackupBuddy: Error Codes

Receive an error code? Check out the Error Codes page for explanations.

Manual Migration

Import fails on file extraction? Learn how to perform a Manual Migration ... it's easier than you'd think!

Additional Resources



BackupBuddy supports the following Multisite functionality:

  • Export a Multisite subsite to standalone
  • Import an exported Multisite subsite into an existing Network
  • Import a standalone WordPress site into an existing Network
  • Backup entire Network (backup/restore only; no migration to new URL)
  • Restore entire Network WITHOUT URL migration for subsites within if migrating to a new URL (URL changes have limitations. Please see Multisite page for details)

Check out the BackupBuddy Multisite Codex and Get BackupBuddy Multisite Beta Today!

BETA indicates that Multisite functionality has known issues and is not reccomended for production use except at your own risk. We do NOT guarantee its functionality or provide guaranteed support for beta products.


  1. Purchase BackupBuddy
  2. BackupBuddy Multisite Codex
  3. BackupBuddy beta Multisite support announcement
  4. BackupBuddy beta Multisite key points everyone is raving about!
  5. PluginBuddy Tutorials
  7. Support Forums