Local Help Docs Troubleshooting

How do I uninstall Local by Flywheel on macOS?


The instructions in this help doc relate to an older version of Local called “Local by Flywheel” and are no longer correct for more recent versions of Local (above v 5.0)

For more information about migrating from Local by Flywheel to the new version of Local, see this help doc:

Migrating from Local by Flywheel to Local “Lightning”

To remove the Local’s Virtual Machine, open VirtualBox and right click on the local-by-flywheel machine. Select “Remove” to delete the Virtual Machine.


This is a destructive step and will cause all of the data within the Local Sites’ Databases to be lost.


Move Local to Trash

Go to /Applications and move Local by Flywheel.app to Trash


(Optional) Uninstall Virtual Box

Uninstall VirtualBox if you no longer want it (see Virtual Box for information on deleting their software.)


Delete User Files

Remove ~/Library/Application Support/Local by Flywheel. You can get to ~/Library/Application Support by opening Finder and pressing Cmd + Shift + G


Edit Your Hosts File

Check your /etc/hosts file and remove the Local by Flywheel block and sites if they exist in there. To edit your /etc/hosts files open Terminal and type sudo nano /etc/hosts