How to Deploy Your DesktopServer Website to WPengine

**Before deploying your website to WPEngine, make sure you are not using any of the WPEngine Disallowed Plugins. If you have any of the plugins from the list in your local site, the deployment has the potential to fail.

The video covers the steps needed for deployment to WP Engine.

If you prefer step-by-step directions, here is what is covered in the video:

1) Create a WordPress instance in WPEngine and create a password.

  • Login to your site and install and activate the DesktopServer for WordPress plugin.
  • Choose the the option to either backup or “No, I already did this”.

2) Create a WP Engine compatible website archive .zip file. 

  • Select DesktopServer’s last option to “Export, import…”, followed by the “Export…” option.
  • Use the drop down combo box to select your development (.dev website) for deployment.
  • In the “Export As” field, enter the domain name of the live site that you will deploy to.
  • Select the option to “Export to a website archive (.zip file), followed by clicking “Next”.
  • Click the checkbox to “Fetch live hosting server details”, and enter your WordPress admin credentials for the live WP Engine site.
  • Do not continue until all the DOCUMENT_ROOT and additional fields are automatically populated, then click “Next”.
  • Chose a file name, output folder, and check or uncheck any of the options you would like to apply to the live site.
  • Clicking “Next”, DesktopServer should prepare a website archive (.zip file) and provide a link to locate it.

3) Extract the files to their own directory before transferring to WPEngine. 

  • After producing a .zip file containing your WP Engine compatible WordPress website, you will want to extract the files to its own directory before to transfer to WP Engine. 
  • Not all files are needed or should be transferred to WP Engine (for instance, do not transfer the database.sql file). 
  • You may then use your favorite FTP program or IDE to transfer the wp-content folder to WP Engine (i.e. via FileZilla, Transmit, Dreamweaver, etc.). 
  • It will only be necessary to upload/overwrite only the wp-content folder. 

4) With your wp-content folder transferred over, you will then need to deploy the database. 

Begin by going back to WPEngine’s Dashboard and selecting the phpMyAdmin utility and the database associated with your live website
  • Visit your WP Engine Dashboard and select the WordPress instance in which you’d like to deploy your site -> phpMyAdmin -> Select Database -> Import
  • Click “Browse” or “Choose File” to select the database.sql file from your local hard drive, followed by the “Go” button and wait for import to complete. Note: If you get a “Script timeout passed, …resubmit same file and import will resume.” error, resubmit the file as many times as needed until the database is fully imported.

5) Your website should now be ready. 

Visit your site to check the links and verify that it is functional. 
Here are a few steps to check if your site fails to display properly:
  • Check that the table prefix in the wp-config.php file matches your local .dev website. You should not transfer the wp-config.php from DesktopServer to WP Engine as WP Engine incorporates a number of proprietary settings within the file. However, the line that reads $table_prefix  = ‘wp_'; (where wp_ is your table prefix) should match. If not, be sure that the WP Engine’s wp-config.php file matches your local development website’s $table_prefix setting.
  • You may also need to reset WordPress’ permalinks. Simply visit WordPress’ admin menu for Settings > Permalinks > Save Changes.