Connect WPEngine to Local –

/ SprUng, Websites - more cheats, wordpress - more cheats / 4 minutes of reading

More from this category



https://wpengine.com/support/local/

 

Connect Local to WP Engine

 

The WP Engine Connect feature will allow Local users to connect any Sites they have created on their WP Engine Account and download associated environments. Additionally if a website was initially setup on WP Engine and you would like to pull that site to Local, WP Engine Connect can help!

 

 

Enable WPE API and Generate Credentials

 

  1. Open the API Access page of your WP Engine User Portal:
  2. Locate the account name you wish to enable access for
  3. Click Manage
  4. Toggle Account API Access to on
  5. Click Generate Credentials to return to the previous page
  6. Click the Generate Credentials button at the top
  7. Leave this page open for easy access in the next step

 

 

See our guide for more information on the WPE API.

 

Connect Local to WP Engine

 

  1. Open the Local application on your computer
  2. Click Connect at the top left
  3. Click LOG IN TO YOUR HOST

 

 

  1. Select WP Engine
  2. Copy and paste your WPE API credentials, from the previous step
  3. Click LOGIN TO WP ENGINE

 

 

 

 

Pull to Local From WP Engine

 

When setting up a site in Local an initial pull will typically be made from WP Engine to copy content locally. After the initial pull, subsequent pulls can be made any time to overwrite you local content.

 

Initial Pull to Local

 

This process needs to take place the very first time you pull to Local from WP Engine.

 

  1. Ensure you’ve already connected Local to your WP Engine account
  2. Open Local on your computer
  3. Go the Connect tab
  4. Locate a Site in the list
  5. Click PULL TO LOCAL
  6. Choose whether or not to include the database

 

 

Subsequent Pulls to Local

 

After the initial pull to Local, additional pulls can be made using the following steps.

 

  1. Open the Local app
  2. Select the Local Sites tab
  3. Select the site name
  4. Click START SITE at the top right
  5. Click PULL TO LOCAL in the lower right
  6. Choose whether or not to include the database

 

 

 

 

Push to WP Engine from Local

 

  1. Open Local connected to WP Engine
  2. Click Start Site on the environment that you want to push
  3. Click the bottom right hand icon to push to WP Engine

 

 

  1. Choose an environment to push to:
    • Production, Staging and Development are all options if already created in User Portal
    • If an environment doesn’t yet exist, click the link to create one from the User Portal
  2. Chose whether or not to push the database
    • Including the database will overwrite all database information on the destination environment
    • It is never advised to include a database when pushing to Production
  3. A success message will display within Local when the push has completed:

 

Site Pushed! Your site has been pushed to WP Engine

 

NOTE: If you do not wish to push your site to WP Engine, you can take it to another hosting provider and upload it to them as well. Be sure to check with the new host first if they accept Local’s formatting and configurations. You can read more in this community forum thread.

 

 

Backup Process

 

Like other files on your computer, backing up your Local sites is essential. Local site are stored in ~/Local Sites, and you may be able to recover sites from this directory. Follow the instructions below for a complete backup:

 

  1. Click Start Site on your Local site to start it
  2. Right-click or CTRL+click on your site
  3. Select Export
    • This will include site files and database in a single .zip archive
  4. Click Export Site
  5. Depending on the size of the site, exports can take several minutes

 

 

Success! You now have a backup of your Local Site. Simply drag this .zip archive into Local to
import from backup.

 

NOTE: If you export your site to your computer and also backup your computer (EX: to an external hard drive), you’ll backup your Local Site backup for extra protection!

 

 

 

 

Manually Import An Environment From WP Engine

 

If the pull from WP Engine fails to import your environment(s), use the following steps to manually import each environment from a backup.

 

  1. Create a backup of the environment
  2. Download the full backup as a zip
  3. Rename the zip file locally to match the name of your environment

    • EX: mystagingenv.zip
  4. Open Local on your machine
  5. Open the File menu
  6. Select Import Site

 

 

  1. Open the file from Step 3
  2. Confirm the Environment name
  3. Click Continue
  4. Select Preferred
  5. Click Import Site

 

Once the import completes, we recommend clicking View Site at the top right to confirm that it works.

 

 

 

Local’s Log

 

When troubleshooting an issue Support may request your Local log file. Version 5 of Local introduced a new file called local-lightning.log. Older versions of Local will use a log file called local-by-flywheel.log.

 

Reveal Local’s Log

 

  1. Open the Local app on your machine
  2. Click the Help menu
  3. Select Reveal Local’s Log
  4. Attach this file when request to a ticket or chat

 

 

Log File Locations

 

If you’d prefer to locate the file on your own, you will need to check in the appropriate location for your operating system.

 

Mac: ~/Library/Logs/local-lightning.log

 

Windows: %AppData%RoamingLocallocal-lightning.log

 

Linux: ~/.config/Local/local-lightning.log

 

Scroll to Top