Installing Local

Installing Local should be easy, but if you’re having trouble, this is the place to start looking!

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 sites that are large or if you need to download and install additional Lightning Services for running a Custom Environment.

Where to Download

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

A screenshot of the Local releases page where you can download the latest version of Local.

OS Specific Instructions

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.
Double-clicking on the Local installer opens the package manager for Ubuntu.
A screenshot of installing Local using apt from the command line.
You can also install Local using sudo dpkg -i from the terminal.