Help Docs – Local

Use Xdebug in Local with PhpStorm

Nick Cernis — Mon, 07 Apr 2025 15:07:42 +0000

Local supports Xdebug in PhpStorm by default using zero-configuration debugging. You do not need to modify files or install browser extensions and Local add-ons. Remove the old Xdebug + PhpStorm add-on if you see it under “Installed Add-ons”. It is no longer needed to use Xdebug with Local and PhpStorm. For each Local site that you want to use with…

Source

Troubleshoot: Windows + Local

Nick Barelos — Wed, 20 Nov 2024 19:05:19 +0000

Windows is the operating system of choice for the majority of Local users, and while Local is compatible with Windows, below we will break down some common troubleshooting steps for Windows users to ensure they can enjoy all of Local’s features! Table of Contents: Local supports Windows 10 (64-bit) and Windows 11. As of version 8.3, Local no longer supports 32…

Source

Mailpit

Ben Turner — Thu, 29 Aug 2024 20:44:35 +0000

Local uses Mailpit to capture emails sent from a site. More specifically, any email that is sent using the PHP mail() function will be captured. Because WordPress’ wp_mail() function uses under-the-hood, you can test emails for a site without actually sending them to the end user. You can get a feel for using Mailpit by resetting the password for a WordPress user…

Source

Change a site’s folder location

Ben Turner — Wed, 29 Mar 2023 15:35:58 +0000

You can’t change the location of an existing site, but you can export that site and re-import it as a new site in a different location. The “Local site path” can be set under the “Advanced Options” of the site creation screen: There is also an option to change the default location of new sites under: Preferences > New Site Defaults Get Community…

Source

Connect a different database tool

Ben Turner — Wed, 29 Mar 2023 15:12:20 +0000

If you prefer to use a different database tool other than Adminer or Sequel Pro, here’s how you can connect your tool of choice to any site in Local As an example, we’ll use MySQL Workbench, but there are many other tools you can use such as DBeaver, HeidiSQL, and Navicat. Table of Contents: Get…

Source

Site Grouping Feature

Ben Turner — Fri, 10 Mar 2023 22:21:26 +0000

Amongst the new features of Local 6.7.0 is the ability to organize sites into groups. This feature also allows you to stop and start an entire group of sites simultaneously. Any sites that are not grouped will stay in the “sites” list. Table of Contents: After updating to version 6.7.0, you will receive a notification that your starred sites have now been…

Source

Downgrade Local Version

Ben Turner — Thu, 15 Dec 2022 19:33:49 +0000

Downgrading Local may be used to troubleshoot issues presented with a newer version or other various reasons. We recommend running Local on the latest version available when possible.

Source

Reset a WordPress admin password

Ben Turner — Mon, 03 Oct 2022 15:10:46 +0000

If you don’t have an admin login or you simply forgot your admin password, this doc will go over how you can gain access to the WordPress admin for a Local site on your computer using WP-CLI. Table of Contents: Right-click on the site in Local’s sidebar and click “Open site shell.” If you’d to reset the password for a current…

Source

Update past Local 6.4.3 – macOS

Ben Turner — Wed, 14 Sep 2022 18:27:58 +0000

You may have noticed that Local’s auto-update broke for Macs when updating to the 6.4.3 release. This was caused by a change in how we sign the Local app for MacOS. Getting back to work is easy! Instead of using the Local’s updater, download and install Local from the website — no need to uninstall first! Redownloading Local shouldn’t impact your existing sites, but it’…

Source

Large sites and Local

Ben Turner — Tue, 21 Jun 2022 14:40:00 +0000

Large sites can sometimes be difficult simply due to their size. The bigger the site the longer things can take and you may need a few options to get things done quicker. Table of Contents: There isn’t a hard size limit when using Local Connect to pull a site from Flywheel or WP Engine. Using Connect to pull a site larger than 5GB can cause issues due to various…

Source