From iThemes Codex
Revision as of 19:54, 13 July 2011 by Ronalfy (talk | contribs) (Created page with '* '''New to BackupBuddy?''' Check out the Getting Started page. * '''Problems?''' Check out the [[BackupBuddy:_Frequent_Support_Issues|Frequently...')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


Getting Started

BackupBuddy MS is a tool that allows you to migrate a self-hosted WordPress install into an existing WordPress Multisite installation.

Self-hosted to Multisite Migration - Prerequisites

1. Use BackupBuddy to perform a full backup of the self-hosted WordPress install 2. Assuming you have an existing Multisite network, upload the BackupBuddy backup file to the network's web root (typically, /public_html/ 3. Upload and Network Activate the BackupBuddy MS plugin on the Multisite network 4. Visit your Network Admin area and click on BackupBuddy MS to begin

Self-Hosted to Multisite Migration - Steps

Step 1 - Create the Site

Step 1 asks you to create the site. If the site already exists, the user will be prompted to use the desired site.

Step 2 - Site Creation Confirmation

Confirm that the intended site is the site you would like to migrate the data into

Step 3 - Choose the BackupBuddy ZIP file

Choose the BackupBuddy ZIP file you would like to use for the migration

Step 4 - ZIP Extraction

This step extracts the BackupBuddy ZIP file into a temporary directory

Step 5 - Copy Media, Plugins, and Themes

This step copies over attachments and other media into the new site's upload directory. Any plugins or themes that do not already exists in Multisite will also be copied over.

Step 6 - Database Migration

This step migrates the database content, first by dropping all the existing tables for the site, and re-creating them using the imported database content.

This step also attempts to replace any old URLs to point to the new Multisite setup.

Step 7 - Users

This step attempts to migrate users into the network, giving them appropriate roles and updating content IDs in the database.

Step 8 - Cleanup

This step attempts to remove the temporary directories and the BackupBuddy ZIP file that was uploaded earlier.

Step 9 - ???

View the site and cleanup any miscellaneous settings you may find.

Server Requirements

  • PHP 5.2+
  • mySQL 5.x+
  • WordPress 3.1+
  • 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:
    • Command-line zip installed and accessible
  • Windows:
    • Windows zip executable (available here)

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 Asked Questions

Will Multisite back to Self-Hosted Ever Be Part of BackupBuddy?

Not at this time. WordPress Multisite is designed to be run as a network, and it would be troublesome to take a site out of that network and re-work it to be run as a standalone site.


Frequently Seen Support Issues

Problems? Start with the Frequently Seen Support Issues to most quickly troubleshoot your problem.

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



  1. Purchase BackupBuddy
  2. PluginBuddy Tutorials
  4. Support Forums