Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Backups & maintenance · Guide

How to Update Local WP (Step by Step)

How to Update Local WP (Step by Step)

Short answer

Open Local and accept the update prompt, or download the latest installer from the Local website and install it over your current copy. Your sites are kept in a separate folder, so they stay in place. Update WordPress inside each site from its own dashboard.

Key takeaways

  • Updating the Local app and updating WordPress inside a site are separate tasks.
  • Local offers updates in the app, or you can install a fresh copy over the old one.
  • Your sites live in a separate Local Sites folder and survive app updates.
  • Export important sites before a major update.
  • Change PHP versions per site from the site's Overview tab.

What does updating Local WP actually mean?

Updating Local can mean three things: updating the Local app itself, updating WordPress inside a Local site, or changing a site's PHP or server versions.

Local is a free desktop app from WP Engine for building WordPress sites on your own computer. It used to be called Local by Flywheel. Each part updates in a different place:

What you are updatingWhere you do itAffects
The Local appLocal's update prompt or a fresh installer from localwp.comThe app and its built-in services
WordPress core, plugins, themesThe site's WordPress dashboardOnly that one site
PHP, web server or databaseLocal's site Overview screenOnly that one site

Most people searching for this want the first one, so we start there. If you have not installed Local yet, see our guide on installing WordPress using Local WP.

How do you update the Local app automatically?

Open Local, wait for the update notice, click to download and install it, and let the app restart; your sites stay in place during the update.

Local checks for new versions when it starts. When one is ready, it shows a prompt or banner offering to update.

  1. Open Local.
  2. Look for an update notice in the app window.
  3. Click the button to download and install the update.
  4. Let Local close and restart.
  5. Check the version number in the app's About or Help area.

You can also check on demand. Look for a Check for Updates option in the app menu or Help menu, depending on your operating system.

Stop running sites before a major update if Local asks you to. The app manages services like PHP and MySQL, and it needs to restart them.

Local's release notes list each version, what changed, and any known issues. Read them before jumping several versions at once.

How do you update Local manually with a new installer?

Download the latest installer from localwp.com, quit Local completely, run the installer over your existing copy, and reopen Local to confirm your sites are listed.

Use this method when the automatic update fails or when you are several major versions behind. Very old versions sometimes cannot update themselves.

Steps for each platform:

  1. Quit Local fully. On macOS, use Local > Quit. On Windows, close it from the system tray too.
  2. Download the installer from the Local website.
  3. Run the installer.
  4. On macOS, open the .dmg file and drag Local into Applications, choosing to replace the old copy.
  5. On Windows, run the .exe and follow the prompts.
  6. On Linux, install the .deb or .rpm package with your package manager.
  7. Open Local and check that your sites appear in the sidebar.

Your sites live in a separate folder, usually named Local Sites in your user folder. Installing the app again does not touch that folder.

Local's help center has a specific page for updating past Local 6.4.3 on macOS, where an older version needed a manual install. Check the help docs if an update keeps failing.

What should you back up before updating Local?

Export any site you cannot afford to lose, or copy the Local Sites folder, before a major app update; sites are rarely lost, but a backup takes minutes.

Local makes this easy:

  1. Right-click a site in the sidebar.
  2. Choose Export.
  3. Save the zip somewhere safe.

The export includes the site's files and database. You can import it back into Local by dragging the zip into the app.

For a full copy of every site, stop all sites and copy the Local Sites folder to an external drive. Our guide to the 3-2-1 backup rule explains why a second location matters.

If you push sites to a live host with Local Connect, your live host also holds a copy. Do not rely on that alone for local-only work.

How do you update WordPress inside a Local site?

Start the site in Local, click WP Admin, go to Dashboard > Updates, and update WordPress core, plugins and themes the same way you would on a live site.

Every Local site is a normal WordPress install. Local does not update WordPress for you.

  1. Select the site in Local and click Start site.
  2. Click WP Admin to open the dashboard.
  3. Go to Dashboard > Updates.
  4. Click Update to version for WordPress core if a new version is listed.
  5. Select plugins and themes and click Update.

The WordPress guide to updating WordPress covers this screen in detail. Our own guide on updating plugins in WordPress covers plugin updates and what to check afterwards.

Local is a great place to test updates before running them on a live site. Copy your live site down, update it locally, and check for problems first.

Prefer the command line? Right-click the site in Local and choose Open site shell.

That opens a terminal with WP-CLI ready, so you can run commands such as wp core update and wp plugin update --all. The WP-CLI command reference lists every option.

The shell is handy when you manage many Local sites. You can update a site in seconds without clicking through the dashboard.

How do you change the PHP version for a Local site?

Select the site, open its Overview tab, click the PHP version, choose a newer one from the list, and let Local restart the site with it.

Local lets each site run its own PHP version, so you can test a site against newer PHP without touching others.

  1. Select the site in the sidebar.
  2. Open the Overview tab.
  3. Click the current PHP version.
  4. Pick a newer version. Local may download it first.
  5. Let the site restart, then test it.

You can change the web server and database version in the same area on many setups. Some changes, such as switching database engines, may only be possible when you create a new site.

Check which PHP versions are still supported on php.net. Our guide on updating the PHP version in WordPress explains how to do the same on your live host.

If the site breaks after a PHP change, switch back to the old version from the same menu and look at the error. Our guide on fixing a site broken after a PHP update lists common causes.

What if Local will not start after an update?

Restart your computer, reopen Local, and check its log file; if that fails, reinstall the latest version or roll back to the previous one using Local's downgrade instructions.

Common problems after an update:

SymptomLikely fix
App opens to a blank windowQuit fully and reopen, or restart the computer
Sites will not startCheck that no other app uses the same ports
Router or domain errorsRestart the Local router from the app's settings
Antivirus blocks servicesAllow Local in your security software
New version is buggyInstall the previous version from the release list

Local's help center explains how to downgrade to an earlier version if a new release causes trouble.

If a site loads in Local but not in the browser, see our guide on WordPress not working on localhost.

For certificate warnings, our article on Local WP SSL not working covers trusting the certificate again.

How often should you update Local?

Update Local when a new version is released, unless you are in the middle of a deadline; reading the release notes first helps you avoid surprises.

New versions bring newer PHP and MySQL builds, bug fixes and support for new operating system versions. Falling far behind makes later updates harder.

A simple routine works well:

Keep in mind that Local updates do not change the sites you have already pushed to a live host. Each live site has its own server, PHP version and update schedule, which your host or you control.

If you collaborate with others, agree on a Local version across the team. Different versions can bundle different PHP builds, which may make one person's copy behave slightly differently from another's.

  • Check monthly for a Local update.
  • Export important sites before a major version.
  • Update WordPress inside each active site at the same time.
  • Delete old sites you no longer need to keep things tidy.

If you use Local as part of a wider workflow, our guide on setting up a local WordPress development environment covers how it fits with version control and staging.

Frequently asked questions

Will updating Local delete my sites?

No. Local keeps your sites in a separate folder, usually called Local Sites in your user folder. Updating or reinstalling the app leaves that folder alone. Exporting important sites first is still a good idea in case something goes wrong.

Why is Local not showing an update?

Very old versions sometimes cannot detect or install new releases. Your network or security software may also block the check. Download the latest installer from the Local website and install it over your current copy instead.

Is Local by Flywheel the same as Local WP?

Yes. The app was called Local by Flywheel and was later renamed Local after WP Engine took it over. Updating from an old Local by Flywheel version works the same way, though very old versions may need a fresh install.

Do Local sites update WordPress automatically?

Not reliably. Local sites run on your computer and only when started, so background update checks may not run. Open each site's dashboard and use Dashboard > Updates to update WordPress, plugins and themes yourself.

Can I go back to an older version of Local?

Yes. Local's help center explains how to download and install an earlier release. Quit Local, install the older version over the new one, and reopen it. Export your sites first in case the older version handles something differently.

Sources

  1. Local releases Local
  2. Update past Local 6.4.3 on macOS Local Help Docs
  3. Downgrade Local version Local Help Docs
  4. Updating WordPress WordPress.org
  5. Supported versions PHP

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.