Set Up WP Ghost on Local by Flywheel – Nginx Configuration Guide

Moved

This tutorial has moved to the new WP Ghost Knowledge Base where each feature is presented in detail.

View on new site

WP Ghost (formerly Hide My WP Ghost) works on Local by Flywheel with Nginx configuration. When using the Nginx server option in Local, you need to select “Local by Flywheel” as the server type in WP Ghost and add one include line to the Local site config file. With Apache in Local, WP Ghost works automatically through .htaccess.

How to Set Up WP Ghost on Local by Flywheel (Nginx)

Step 1: Select the Local by Flywheel Server Type

Go to WP Ghost > Advanced > Compatibility. Select the server type as “Local by Flywheel”. This tells WP Ghost where to generate the config file and how to format the include path.

WP Ghost Advanced Compatibility settings with Local by Flywheel server type selected

Step 2: Activate Safe Mode or Ghost Mode

Go to WP Ghost > Change Paths > Level of Security. Select Safe Mode or Ghost Mode. Customize paths or keep the defaults. Click Save.

WP Ghost Level of Security showing Safe Mode selected

Step 3: Copy the Include Line

After saving, WP Ghost displays a message with the include line you need to add. Copy the line include includes/hidemywp.conf.

WP Ghost notification showing the include line to add to Local by Flywheel config

Step 4: Add the Include Line to the Local Config

Open the Local site folder. Edit the file conf/nginx/site.conf.hbs. Add the include line before the WordPress rewrite rules.

Local by Flywheel site folder showing the conf/nginx/site.conf.hbs file location
site.conf.hbs file showing the include line added before WordPress rewrite rules

Step 5: Restart the Local Server

In the Local by Flywheel panel, restart the site to reload the Nginx configuration with the new include.

Local by Flywheel panel showing the restart button for the site

Step 6: Run the Frontend Test

After the server restarts, click the Frontend Test button in WP Ghost. Check that the frontend loads correctly. Test in an incognito window or a different browser. If everything works, click “Yes, it’s working”. If not, click “No, abort” to roll back to previous settings.

WP Ghost Frontend Test confirmation dialog with Yes it's working and No abort options

Troubleshooting

Paths return 404 after configuration. The include line was not added correctly or the server was not restarted. Verify the line is in conf/nginx/site.conf.hbs before the WordPress rules. Restart the site from the Local panel.

Using Apache in Local instead of Nginx. If your Local site uses Apache as the web server, WP Ghost works automatically through .htaccess. No config file editing needed. Just activate Safe Mode or Ghost Mode and save.

Frontend Test fails. Click “No, abort” to roll back immediately. Check that you selected “Local by Flywheel” as the server type in WP Ghost > Advanced > Compatibility.


Frequently Asked Questions

Is this setup needed when using Apache in Local?

No. This guide is only for the Nginx server option in Local. With Apache, WP Ghost works automatically through .htaccess.

Do I need to repeat this after changing paths?

WP Ghost updates the hidemywp.conf file automatically. You may need to restart the Local server for Nginx to pick up changes. The include line itself is a one-time addition.

Does this apply to Flywheel hosting (not Local)?

Flywheel hosting (the cloud service) has a different setup. Flywheel hosting does not provide direct Nginx config access. Contact Flywheel support with the include line WP Ghost generates. This guide is specifically for the Local by Flywheel desktop app.

Does WP Ghost modify WordPress core files?

No. WP Ghost generates a hidemywp.conf file and uses WordPress hooks. No core files modified. Deactivating restores all defaults.


Nginx Server Setup – general Nginx configuration for WP Ghost.

Customize All WordPress Paths – configure paths after server setup.

Theme Not Loading Correctly – troubleshoot path issues.

Emergency Disable Guide – recovery if configuration causes issues.

Compatibility Plugins List – hosting and server compatibility notes.