WordPress Site Configuration
Depending on your existing development tools and needs, there are multiple ways to source data as you develop your site locally. WP Engine's Local WordPress development environment offers existing WP Engine or Flywheel customers the most robust feature set, but we understand that Atlas users may have different tooling or wish to develop directly against their production WordPress instance. Below you can find a short summary of the various approaches to working with a local headless WordPress site:
- Connect Directly to the Remote WordPress Site
- Non-Local WordPress Development Environments
- WP Engine's Local Development Environment
If you choose this method, no local WordPress site setup is required.
You will need to follow the documentation those products provide for creating a local WordPress site and migrating a copy of your WordPress site to your local machine. Once you have made the site available via one of these tools, you will need to replace the WordPress URL in your environment variables file to finish the connection.
Local is a free app for local WordPress site development, and its Local Connect feature allows you to easily pull down a WP Engine-hosted WordPress site to your local machine.
Here are the steps to follow:
- Install Local if you don't already have it on your computer.
- Follow the Local Connect documentation. Select WP Engine as the hosting provider you'd like to connect to and pull down the WordPress site associated with your Atlas app.
When finished, you should have a local version of the WordPress site set up.
See the Local Help Docs for further documentation on working with Local.
NOTE: There is a known issue using Local's SSL certificates on MacOS versions Monterey and Big Sur. If you are using one of those versions, you will need to manually trust the certificates to use HTTPS.
If you created your WordPress site from the WP Engine User Portal, you may not know the password for your WordPress user account. You'll need that in order to log into the WordPress admin on your local machine. Here's how you can reset your password:
Make sure your site is up and running in Local.
Right-click on your site's name in the sidebar and click
Open site shell.
Your command line app will open and a command will be executed to open an SSH connection to the local WordPress site. You should see output similar to this:
$ /Users/john.smith/Library/Application\ Support/Local/ssh-entry/WLLn7jJ4a.sh; exit-n -eSetting Local environment variables...----WP-CLI: WP-CLI 2.5.0Composer: 2.1.5 2021-07-23PHP: 7.4.1MySQL: mysql Ver 8.0.16 for macos10.14 on x86_64 (MySQL Community Server - GPL)----Launching shell: /bin/zsh ...
wp user update email@example.com --user_pass=passwordon the command line, where
firstname.lastname@example.org the email address for your WP Engine account and
passwordis the new password you'd like to use to log into your local WordPress site.
If your password was updated successfully, you will see output similar to this on the command line:
Success: Updated user 1.
You should now be able to click the
Admin button in Local and log into the WordPress admin using the email address for your WP Engine account and the new password you set.
In many app configuration, including the Faust.js starter, you will store the URL of the WordPress site where the app sources its data in the environments variable file:
.env.local. If you want the app to source its data from your local WordPress site instead, replace this value with the URL of your local WordPress site.
As an example, if your project has a
NEXT_PUBLIC_WORDPRESS_URL environment variable and your local WordPress site URL is
http://my-site.local, then that environment variable should be updated to
When finished, save the environment variables file. This will result in you having separate
.env files for both your local and production environments. If need more guidance on creating environment variable files or setting variable values, you can reference the define environment variables section of the previous guide.
Congratulations! You should now have a fully-functioning Atlas application, complete with a development environment on you local machine suited to your needs. Here are a few additional guides about the Atlas platform that you may be interested in reading: