Install Local

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

Table of Contents:

Where to Download

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

Download Local

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 Catalina (10.15) 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:

Windows 7/8/8.1 will no longer be compatible with the release of Local v8.0.
Local is an Electron app; to ensure we’re staying up-to-date with the latest improvements and security fixes, we’ll be updating Local to Electron v25 soon. In line with Microsoft’s and Chromium’s end-of-support policy, this version of Electron no longer supports Windows 7/8/8.1

note

Local can be installed on macOS versions before macOS Catalina (10.15) 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.

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: