Local Help Docs Connect

Connect to Flywheel with Local

What is Connect to Flywheel?

Connect to Flywheel is a feature of Local that lets you easily move sites between a local environment and your live environment hosted on Flywheel. This dramatically streamlines the go-live process and it’s totally free to Flywheel users!

1

To connect your Local and Flywheel sites, you’ll first need to log in to your Flywheel account inside the Local application on your computer (version 2.1 or later).

You can download the latest version of Local here, or just quit and relaunch the application to upgrade your version.

Click on the This image has an empty alt attribute; its file name is Local-connect.png icon on the left-hand toolbar. From here, you just need to click on the “Log in to Flywheel” button. Your browser will open automatically so you can enter your Flywheel username and password.

Now you just need to hit the “Log in with [Your Username]” button.

Now that you’re logged in to your Flywheel account, you’ll get redirected back to Local. You’ll know you’ve logged in successfully because your Flywheel sites will now be listed within Local!

2

Now we can easily push and pull sites to and from Flywheel.

To pull a Flywheel site down to your Local environment, start on the Connect to Flywheel tab. Click the “Pull to Local” button on the site you want to pull. You’ll be able to change the name of the Local site and edit advanced options, which lets you customize the domain and site path. When you’re ready, click “Connect & pull site.” After your site is done being pulled, you’ll be able to see it on the Local Sites tab where you can make any changes you need in a local environment!

note

The amount of time it takes to push or pull your site to or from Flywheel will differ from site to site and is dependent on both the size of your site and your internet speed.

After you’ve made the appropriate changes on your Local site, you can push it back to the live Flywheel site.

You just need to click on& the icon on the bottom right of the Local app for the desired site you want to push.

You’ll then be prompted with a pop-up that gives you the opportunity to exclude pushing the database. After deciding whether or not to exclude it, you’ll be ready to hit the “Push to Flywheel’ button.

note

A backup will be made of the Flywheel site before its contents are replaced by the Local site.

That’s it! Pretty easy, right?

Connect to Flywheel FAQ

Can I push a new Local site to Flywheel?

Yes! Simply go to the site in your Local Sites tab and click on the Push to Flywheel icon in the bottom right corner. The site must be a Preferred environment and not a Custom environment.


Can I push to staging? Pull from staging?

Yes! Both Local Pro and Local for Teams allow pushing a site to the staging site.


Can I log in to more than one Flywheel account at once?

No. Only one Flywheel account is supported at this time, but you can always log out from one profile and log in to another!


It seems like some of my sites are not compatible. What’s the deal?

The following limitations exist:

  • You can only push a Local site that uses the Preferred setup (rather than Custom).
  • You can only pull a Flywheel site if the Local site uses the current Local Preferred setup PHP version.
  • You can only push a Local site to a Flywheel site if the remote Flywheel site is on the newer (7.x) version of PHP.
  • You cannot pull a Flywheel site that is Multisite.
  • You cannot push a Local site that is Multisite.

Didn’t find the answer you’re looking for? Fear not! You can visit the awesome Local Community forums here.