Restoring a Full Site Using Importbuddy

A BackupBuddy Full Backup can be used to restore a site; the ImportBuddy file can be used to migrate your entire site to another hosting server.

A BackupBuddy Manual Restoration involves manually uploading the ImportBuddy script and a Complete (Full) Backup to a destination server.

Steps for Migrating/Restoring Your Site

1. Get Your Backup
2. Adding ImportBuddy to Your New Location
3. Adding Files to Your New Location
   1. Using (s)FTP
   2. Stash
   3. Upload
4. ImportBuddy Steps 
   1. Authentication Required & Choose Your Backup File
   2. Unzipping Backup File
   3. URL and Database Settings
   4. Database Import
   5. Database Migration
   6. Final Cleanup

Note:  If you only need to restore a single file or a limited number of files, use BackupBuddy's Built-in Restore feature.

Step 1 - Get Your Backup

We always recommend that you store your backups and a copy of ImportBuddy in an offsite location such as BackupBuddy Stash in case you're not able to access your server.  If you have done that already, you can download the backup file you want to use to restore your site from that location.

If you haven't done this and can still access your server, you'll be able to find your backups in /wp-content/uploads/backupbuddy_backups on your server.

If you can access your site, you can download the necessary files from BackupBuddy > Backups > ImportBuddy. 

Step 2 - Adding ImportBuddy to Your Server

Once you've downloaded your backup file, you'll need to send a copy of the importbuddy.php file to your server.

We always recommend that you keep a copy of ImportBuddy someplace you can access if your site goes down, like in your Stash storage.  

If you still have access to your site, you'll find ImportBuddy in BackupBuddy > Backups > ImportBuddy.  Here, you can either download the importbuddy.php file or send it to a remote destination.  

Step 3 - Adding files to your new location

Note:  If you sent your backup and importbuddy.php files to a remote destination in the previous steps, you can skip Step 3.  

Using (s)FTP -

Once you have both your backup and importbuddy.php files, you'll need to upload them to the location. 

First, you'll need to upload it to the FTP directory to restore the backup to that corresponds to the web URL for your site's destination.  For example, if you want your site's URL to be http://your.com/mybuddy/ then your server directory MIGHT be something like this:  /user/username/public_html/mybuddy/ 

Note: The directory structure varies host to host but often follows a similar format.

Once you've decided on the FTP directory, you will then upload the backup file (do not rename the zip file) and a copy of your importbuddy.php file to your chosen directory via FTP.  

Once you've uploaded the ImportBuddy file to your location, you'll go to ImportBuddy's location in your browser where you'll enter your ImportBuddy password.  For example:  mysite.com/importbuddy.php

You'll then see three options - Server, Upload and Stash.  Under Server, you'll be able to select from any backup files you've uploaded to that location on your server.

Using Stash - 

If you've sent your backup file to your Stash storage, you will still need to upload your importbuddy.php file to the site directory through FTP or you can send it to the location through your dashboard (BackupBuddy > Restore/Migrate).  

If you use FTP, you'll need to upload it to the FTP directory to migrate or restore the backup to that corresponds to the web URL for your site's destination.  For example, if you want your new site's URL to be http://your.com/mybuddy/ then your server directory MIGHT be something like this:  /user/username/public_html/mybuddy/ 

Once you've uploaded the ImportBuddy file to your location, you'll go to ImportBuddy's location in your browser where you'll enter your ImportBuddy password.  For example:  mysite.com/importbuddy.php

Once you've entered your password, you'll select the Stash tab where you'll need to log into your Stash account so you can retrieve your backup file.

Once you've logged into Stash, you'll be able to select from your backup files stored there to use for your migration/restore.

Using ImportBuddy -

You'll first upload importbuddy.php to the new location of your site.  You'll need to upload it to the FTP directory to migrate or restore the backup to that corresponds to the web URL for your site's destination.  For example, if you want your new site's URL to be http://your.com/mybuddy/ then your server directory MIGHT be something like this:  /user/username/public_html/mybuddy/ 

Once you've uploaded the ImportBuddy file to your new location, you'll go to ImportBuddy's location in your browser where you'll enter your ImportBuddy password.  For example:  mysite.com/importbuddy.php

You'll then see three tabs - Server, Upload and Stash.  Select Upload and you can upload your backup file.

ImportBuddy Steps

There are 6 ImportBuddy steps to go through for a successful migration/restoration.  You've actually already covered the first step by entering your password and selecting your backup file.

Step 1 - Authentication Required & Choose Your Backup File

You'll be prompted to Enter your ImportBuddy password to continue. For more information about setting your ImportBuddy password, visit the ImportBuddy Password page.

Step 1 also prompts you to choose your backup file for the migration. These file options are divided into three tabs: Server, Upload and Stash.

Note: During Step 1 you'll find Advanced Options. Select any optional advanced options if needed or directed by technical support.

Once you've selected your Advanced Options or if you do not need to select any of these options, click Next Step.

Step 2 - Unzipping Backup File

This step unzips the backup file. There is nothing you need to do for this step. Just select Next Step once the extraction has completed

Step 3 - URL and Database Settings

This is where you will enter the database settings for the new location.

Enter the following URL settings:

WordPress Address - This is the address where you want the final WordPress site you are restoring/migrating to reside. Ex: http://foo.com/wp

Use optional custom site address (Home URL)? - OPTIONAL. This is also known as the site address. This is the home address where your main site resides. This may differ from your WordPress URL. For example: http://foo.com

Enter the following Database Settings:

These settings control where your backed up database will be restored to. If you are restoring to the same server, the settings below will import the database to your existing WordPress database location, overwriting your existing WordPress database already on the server. If you are moving to a new host you will need to create a database to import into. The database settings MUST be unique for each WordPress installation. If you use the same settings for multiple WordPress installations then all blog content and settings will be shared, causing conflicts!

MySQL Server - This is the address to the mySQL server where your database will be stored. 99% of the time this is localhost. The location of your mySQL server will be provided to you by your host if it differs.

Database Name - This is the name of the database you want to import your blog into. The database user must have permissions to be able to access this database. If you are migrating this blog to a new host you will need to create this database (ie using CPanel or PHPMyAdmin) and create a MySQL database user with permissions.

Database User - This is the database user account that has permission to access the database name in the input above. This user must be given permission to this database for the import to work.

Database Password - This is the password for the database user.

Database Prefix - This is the prefix given to all tables in the database. If you are cloning the site on the same server AND the same database name then you will want to change this or else the imported database will overwrite the existing tables.

If you haven't set up a database for the new location, but have access to cPanel for the new site, you can create your new database through cPanel in ImportBuddy's Step 3. To create your database, click the Have cPanel? Click to create a database button.

In the window that opens, you can automatically create a database along with a new database user with permissions. Fill out the required information and then click Create Database.

Once you've entered all the new database information or created your new database, click Next Step.

Step 4 - Database Import

Step 4 imports the database information into the database of your new site. Once the import is completed, click the Next Step button.

Note: Advanced options are also available during Step 4. These advanced options allow customizations of various ImportBuddy functionality for custom purposes or troubleshooting. Exercise caution as some advanced options may have unforeseen effects if not used properly, such as overwriting existing files or erasing existing database content.

Step 5 - Database Migration

This step updates all of the URLs, paths, etc. on your site to match your new site.

Before you move to the final step, be sure to go to your new site and check all of your links to ensure they have changed. You may view your entire import log for providing to support by clicking the View Import Log button.

Once you've tested your new site, you can move to the final step by clicking Clean up & remove temporary files.

Step 6 - Final Cleanup

Step 6 removes any temporary files from your new site that were used for the migration. Your site will then be ready at the URL indicated on that page.