Plugin how-tos · Guide
How to Install WordPress Using Local WP (Step by Step)

Short answer
Download and install the free Local app, then click the plus button and choose Create a new site. Name the site, pick the Preferred environment, enter an admin username, password and email, and click Add Site. Local then installs WordPress and adds a WP Admin button.
Key takeaways
- Local is a free desktop app for running WordPress on your own computer.
- It sets up PHP, the web server and the database for you.
- Choose a Custom environment to match your live host's PHP version.
- Use the WP Admin button or one-click admin to log in.
- Move a finished site to a host with a migration plugin.
How do you install WordPress using Local WP?
Download and install the free Local app, click the plus button to create a new site, name it, pick the preferred environment, set an admin username and password, and Local installs WordPress on your computer in a few minutes.
Local, often called Local WP or Local by Flywheel, is a free desktop app for running WordPress on your own computer. It is made by WP Engine and works on Windows, macOS and Linux.
It handles the web server, PHP and database for you. You do not need to install XAMPP or edit configuration files.
This guide covers installing Local, creating your first site, logging in and the tools you will use most. For a broader look at the options, see our guide to setting up a local WordPress development environment.
Why install WordPress locally with Local?
A local site lets you test themes, plugins, code and updates safely and quickly, with no hosting cost and no risk to your live website.
Common reasons to use Local include:
- Learning WordPress without paying for hosting.
- Testing plugin or theme updates before running them on a live site.
- Building a new site offline, then moving it to a host when ready.
- Developing code with debugging tools turned on.
A local site is private. Only you can see it, unless you share a temporary link, which Local offers as a feature.
If you want a copy of your live site that runs on your host instead, a staging site may be better. Our explainer on what a staging site is covers the difference.
What do you need before installing Local?
You need a reasonably modern Windows, macOS or Linux computer, administrator rights to install software, and a few gigabytes of free disk space for the app and your sites.
Local runs real server software in the background. That uses memory and disk space, especially if you run several sites at once.
Administrator rights matter because Local edits your computer's hosts file. That is how an address like mysite.local opens your local site in the browser.
Check the current system requirements on the Local website before downloading, since they change as new versions come out.
Step 1: How do you download and install Local?
Go to the Local website, click download, choose your operating system, fill in the short form if asked, then run the installer like any other desktop app.
- Visit the Local website and click Download.
- Choose Windows, macOS or Linux.
- Run the downloaded installer.
- Follow the prompts and allow any permission requests.
- Open Local when the install finishes.
On first launch, Local may ask you to create or sign in to a free account. An account is optional for basic use, but some features, such as sharing links and cloud backups, need it.
On macOS, you may need to approve the app in your security settings the first time. On Windows, accept the prompt that lets Local change network settings.
Step 2: How do you create a new WordPress site?
Click the plus button in the bottom left corner, choose Create a new site, type a site name and continue; Local suggests a local domain such as yoursite.local.
- Click the + button at the bottom of the sidebar.
- Choose Create a new site and click Continue.
- Enter a site name, such as testsite.
- Open Advanced options if you want to change the domain or site path.
- Click Continue.
Local also lets you create a site from a blueprint, which is a saved starting point with your favorite theme and plugins. That is handy once you build sites often.
If you want a WordPress Multisite network, Local supports that in the advanced options as well. The Local help docs explain the multisite setup.
Step 3: How do you choose the environment?
Pick Preferred for the recommended PHP, web server and MySQL versions, or Custom if you need to match your live host's PHP version and server type.
| Option | What you get | When to use it |
|---|---|---|
| Preferred | Local's recommended PHP, web server and database | Learning, quick tests, new projects |
| Custom | Your choice of PHP version, nginx or Apache, and database version | Matching a live host before testing updates |
Matching your host helps when you test updates. A plugin that works on one PHP version may fail on another.
You can check your live site's PHP version in Tools > Site Health > Info. The official WordPress requirements page lists the versions WordPress recommends.
Step 4: How do you set your WordPress login details?
Enter an admin username, a password and an email address, then click Add Site; Local downloads WordPress, creates the database and finishes the install automatically.
- Type a WordPress username. Avoid admin, even locally, so the habit sticks.
- Enter a password.
- Add an email address.
- Click Add Site.
Local may ask for your computer password at this point. That is for updating the hosts file, not for WordPress.
The install usually takes a minute or two. When it finishes, the site appears in the sidebar with a green dot to show it is running.
Write the login down. Local does not send it to you by email, since email on local sites does not leave your computer.
Step 5: How do you open the site and the dashboard?
Click Open site to view the front end, or click WP Admin to go straight to the dashboard; you can also turn on one-click admin to skip the login screen.
The site overview screen in Local shows the main buttons and settings:
- Open site opens your local domain in the browser.
- WP Admin opens the login screen at /wp-admin.
- One-click admin logs you in automatically as a chosen user.
- Site domain and SSL let you change the address and trust a local certificate.
If the browser shows a certificate warning, click Trust next to SSL in Local, then reload the page.
Our guide on opening the WordPress dashboard on localhost covers logins for other local tools too.
Which Local tools are worth knowing?
The most useful tools are the database manager, the site shell, the mail catcher, Live Links for sharing and the export option for moving sites.
| Tool | What it does |
|---|---|
| Database tab | Opens a database manager to browse and edit tables |
| Site shell | Opens a terminal with WP-CLI ready to use |
| Mail catcher | Catches emails WordPress sends so you can read them |
| Live Links | Creates a temporary public link to show a client |
| Export | Packs the site into a zip file for backup or sharing |
| Go to site folder | Opens the files in your file manager or code editor |
The site shell is great for running WP-CLI commands, such as updating plugins or searching and replacing URLs.
Your site files live in a folder called Local Sites in your user folder by default. The WordPress files are inside the app and public subfolders.
How do you turn on debugging in a Local site?
Open the site folder, edit wp-config.php, set WP_DEBUG to true, and save; errors then appear on screen or in the debug log.
Local sites are the safest place to see raw errors. Visitors never see them, because nobody else can reach the site.
Our guide on enabling debug mode lists the exact lines to add.
Local also supports Xdebug for step-by-step debugging. See our guide on profiling WordPress with Xdebug if you want to go deeper.
How do you move a Local site to a live host?
Use a migration plugin to package the site and import it on the host, or use Local's built-in Connect feature if your host is WP Engine or Flywheel.
For most hosts, a migration plugin is the simplest route. Install it on the local site, export, then import on the live WordPress install.
Local's Connect feature pushes and pulls sites to WP Engine and Flywheel accounts directly. Other hosts need a plugin or a manual move.
Before moving, change any hardcoded local URLs. Migration plugins usually handle the search and replace for you.
What problems can happen with Local?
Common issues are sites that will not start, browser certificate warnings, port conflicts with other server software, and a blocked hosts file on locked-down computers.
- Site will not start. Restart Local, then your computer. Check for antivirus software blocking the app.
- Certificate warning. Click Trust next to SSL in the site overview.
- Port conflict. Close other local servers such as XAMPP or MAMP, or change Local's router mode in its preferences.
- Domain does not resolve. Local could not edit your hosts file. Run Local with admin rights or check company device policies.
The Local community forums are active and searchable if you hit something unusual.
Frequently asked questions
Is Local WP free?
Yes. Local is free to download and use for creating and running WordPress sites on your computer. Some cloud features linked to an account may have limits, so check the Local website for details.
Can other people see my Local site?
No, a Local site runs only on your computer. If you want to show it to someone, use the Live Links feature to create a temporary public address. When you turn the link off, the site is private again.
Where are my Local site files stored?
By default, Local stores sites in a folder called Local Sites inside your user folder. Each site has its own folder, and the WordPress files sit in the app and public subfolders. The Go to site folder button opens it directly.
Can I use Local instead of XAMPP?
Yes. Local and XAMPP both run WordPress locally, but Local is built for WordPress and handles the install, database and domain for you. XAMPP is more general and needs more manual setup. Avoid running both at once, since they can fight over ports.
Why can't I receive emails from my Local site?
Local catches outgoing emails instead of sending them, so test emails never reach a real inbox. Open the mail catcher from the site's tools to read password resets and form messages sent by WordPress.
Sources
- Local WP Engine
- Local Help Docs WP Engine
- Requirements WordPress.org
- WP-CLI Commands WordPress Developer Resources
- Local Community Forums WP Engine
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.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


