If you're trying to pull a site from one of your Flywheel slots and Local is giving you strange errors, the fix is simple.

Simply log out in the Connect to Flywheel tab and reconnect. While you're at it, make sure you're running the latest release version of Local.

Now for a little more of an explanation.

Error Pulling Site Scenario

You click on the Connect to Flywheel tab and under Available Sites you select Pull to Local. It goes through the motions and when it's done you see this error:

Local by Flywheel Error Pulling Site

The site shows up under Local Sites but doesn't start and your directory doesn't have the site listed.

You restart your web environments and the entire Local application. When it starts back up you get different errors.

Looking at the overview of your newly pulled site you see the environment is unavailable, thus unable to even start.

Local by Flywheel Error Environment Unavailable

You also get a popup error that stipulates the same thing. The environment is undefined.

Local by Flywheel Cannot Find Environment

And you also see an error heading stating the site container is missing as well. Boy, Flywheel really wants you to see there is something wrong! This isn't a bad thing.

Local by Flywheel Error Site Container is Missing

At this point you realize that you changed your email or password to your Flywheel account. Flywheel uses a security token to associate your account and now your old token is invalid. Unfortunately, they do not prompt you or error anything out before this point.

You click on the Connect to Flywheel button and look for your account options in the top right of the application.

Connect to Flywheel

You click on your name and click log out.

Flywheel Logout of Local

You can restart here if you want but the goal is to reauthenticate your account. You'll be redirected to their web service and they'll ask permission to redirect back to Local.

Local by Flywheel Login Website After Local

Local by Flywheel Open Local to Finish Login

Giving it another try, you'll find yourself in familiar territory. Flywheel is packing up the files to get ready to transport. This can potentially take a while.

Local by Flywheel Packing Up Site

Now you will see the actual pulling dialog showing the data transfer.

Local by Flywheel Pulling Site Download

Finally, before we're able to view the pulled site, you'll see all the files that need to extract.

Local by Flywheel Extracting Site Import

That's it, then everything will be back to normal.

Potential Fixes For Other Issues

So if you see any weird errors like:

  • Unable to back up database after stopping site
  • Other SQL issues
  • Can't push or pull site to or from flywheel due to the sites not being recognized as WordPress setups when they really are
  • Site container is missing
  • And potentially more

It goes a long way to stop all running sites and trying the following:

  • Make sure you're running the latest stable version of Local
  • Try to start and stop each site
  • Restart Local
    • If you have Virtualbox installed, use the window preview to make sure Docker and other Flywheel initiated routines are starting
  • Sometimes stopping and restarting Local may be necessary multiple times depending on resources
  • Try restoring any affected sites
  • For pulling or pushing sites, you will need to have them running for the push or pull buttons to actually work
    • Click on the Connected to Flywheel cloud icon on the left menu of Local
    • Then in the top right corner, click on your name and log out
    • Then log back in
    • Click Accept
    • Open or allow when it prompts you to and then everything will be back to normal in Local

Hopefully this helps other people out there. Local by Flywheel is a great web development application but sometimes it can be irritating to work through all the issues.

Fortunately, they are descriptive enough in their error reporting to give you context. And if they weren't they have system logs and router logs. That's always appreciated.

Other than that, you can check out their community forums at the Local by Flywheel Community.

Do you use Local? If not, what local web development application do you use? What are the types of errors you come across?

Pin It on Pinterest