Install Local

Installing Local should be easy, but if you’re having trouble, this is guide should help!

Where to Download

You can get the latest version of Local by visiting the releases page and downloading Local for your specific Operating System.

Minimum Requirements

In general, you’ll need at least:

  • 4Gb of RAM
  • 1.5GB of disk space

This should be enough to install Local as well as create a few new WordPress sites using the Preferred Environment.

You’ll need more disk space if you are working on large sites or if you need to download and install additional Lightning Services to run a Custom Environment.

For macOS users:

  • macOS Monterey (12) or higher
  • Rosetta 2 is required for Local’s Apple Silicon build due to the Nginx and MySQL Lighting Services compiled on the Intel architecture.

For Windows users:

note

Local can be installed on macOS versions before macOS Monterey (12) and Windows 7, 8, and 8.1; however, users will not have the full functionality of the latest Local version. If you’re on an older version of macOS or Windows and unable to upgrade, you’ll need to install a version of Local before v6.5 (for Mac) and v8.0 (for Windows) for full functionality. Here is a help doc on how to downgrade your Local version.

In some instances, users have encountered the need for their IT or internal Security Team to authorize URLs utilized by Local for the seamless operation of our application on their network. To facilitate this process, we recommend adding the following main URLs to any allowlist. We’ve also included a brief explanation of their purpose for clarity: 

Connects the Local Desktop app to the Local Web account. Certain Web-focused features require Local Web to do things on the Desktop app’s behalf. For example, the Backups Addon or Live Links feature.

To use Connect to WP Engine, the Local desktop app needs to generate and upload a key to WPE.

Powers the Connect to Flywheel functionality.

Local Desktop is bundled with preferred services (php/mysql/nginx), but will reach out to this domain to download additional services as you select them.

macOS

Installing Local on macOS is like any other application. Download the Local installer, double-click on the .dmg file, and move Local to the /Applications folder.

Windows

Installing Local on Windows is like any other application. Download the Local installer, double-click on the application and follow the prompts.

Once the main Local application has been installed, create your first site. Due to the way that security is handled under Windows, it’s likely that you’ll encounter a number of pop-ups from Windows Defender.

You’ll need to click the “Allow access” button on each of these so that the various parts of Local can communicate on the network.

If for some reason you miss those pop-ups, you can always update the settings within the “Allowed Apps” section of “Windows Defender Firewall” settings.

A screenshot of installing Local on Windows.
A screenshot of the various Windows Defender popups that show the first time creating a site in Local.

Debian-Based Linux

We compile a .deb version of Local and do some QA under Ubuntu and Pop_OS. It’s likely that Local will work under other distributions, we just haven’t tried it!

The process of installing Local under these systems is pretty easy and can be done by either:

  1. Double-clicking on the .deb file to launch the package manager for your system.
  2. Install the .deb using apt on the command line.
A screenshot of double-clicking on the Local installer opens the package manager for Ubuntu.