Install Joomla locally: the 5 localhost steps

To install Joomla locally you install a local server stack such as XAMPP, MAMP, or WAMP, create a database, download Joomla, and run its web installer at localhost. It works, and it keeps the site private and free. But it is more plumbing than the job usually needs, and on Joomla 6 a default XAMPP will not even meet the requirements without hand-upgrading its parts. If the reason you want it local is a private, free, throwaway site to test on, you can run Joomla in your browser with nothing to install at all. This guide covers the real localhost steps, what they cost, and the faster no-install route. Want to skip ahead? You can open a free Joomla test site right now and read the rest after.

How do you install Joomla locally?

You install a local server stack, create a database, download Joomla, and run the web installer in your browser at localhost. The official Joomla manual describes the same sequence: create a database, then “start the Joomla web installer by opening your favourite browser” and browsing to the site (Joomla Project, Installing Joomla, 2026). Here are the five steps in order:

1. Install a local server stack. Download and install XAMPP, MAMP, or WAMP, which bundle a web server, PHP, and a MySQL or MariaDB database for your own machine.
2. Start the server and create a database. Start Apache and MySQL, open phpMyAdmin, and create an empty database with a name, a user, and a password for Joomla to use.
3. Download and unzip Joomla. Download the current Joomla package from the official downloads site and extract it into the web root, such as the htdocs folder.
4. Run the web installer. Open localhost in your browser, follow the Joomla web installer, and enter the database details you created a moment ago.
5. Check the version requirements. Confirm your PHP and database meet Joomla's minimums. Joomla 6 needs PHP 8.3 and MariaDB 10.6, which a default XAMPP does not ship, so you may have to upgrade its parts first.

None of these steps is hard on its own. Together they are the reason “install Joomla locally” is a search in the first place: a web server, a database, a download, and an installer, each with its own way to go wrong, before you have tested a single thing. A current walkthrough of the XAMPP route lays out the same sequence, from starting Apache and MySQL to extracting Joomla into htdocs (GeeksforGeeks, install Joomla on localhost using XAMPP, 2025). For a side-by-side of every route, our guide on how to spin up a free Joomla test site compares local, hosted, and sandbox options.

What do you need to run Joomla on localhost?

Joomla needs a web server, PHP, and a MySQL or MariaDB database. The current release, Joomla 6.1.0, shipped on 14 April 2026 (Open Source Matters, Download Joomla 6.1.0, 2026), and Joomla 6 sets a strict minimum of PHP 8.3 and MariaDB 10.6, with MySQL 8.0.13 as the MySQL floor (Joomla Programmers Documentation, Technical Requirements, 2026). A local stack like XAMPP bundles those parts, which is why people reach for it. The catch is that the bundle can be older than Joomla wants.

This is the part that catches people out. The current default XAMPP for Windows ships PHP 8.2.12 and MariaDB 10.4.32 (Apache Friends, XAMPP downloads, 2026), and both sit below Joomla 6’s minimum. So a freshly downloaded XAMPP can refuse to install Joomla 6 until you manually swap its PHP and database for newer builds, which is exactly the kind of setup a local test environment was supposed to save you.

A local Joomla install is more work than it looks

You own the whole environment, from setup to teardown, and every part of it is your job to maintain. A local install means you install the stack, start Apache and MySQL, create a database, run the installer, and then remember to delete it all afterwards so it does not sit on disk. None of that is Joomla. It is the cost of admission you pay before, and after, every clean test.

The upkeep is the quiet tax. Each localhost site is a folder in htdocs that you patch, back up, and eventually forget, which is how a machine ends up with three half-broken Joomla copies nobody remembers building. The local-stack tooling drifts too. In one Joomla community thread a developer asks, “Obviously, MAMP Pro on Mac is dead, what are you using instead for your local environment?” (templaza/astroid-framework discussion #654). When the tooling itself is in flux, a fresh, disposable install with nothing to maintain starts to look like the sensible default.

Can you run Joomla locally without installing anything?

Yes, if what you actually want is a private, free, disposable Joomla test site to work on. An online sandbox gives you that with nothing to install: JInstant hosts a clean Joomla 6.1 or 5.4 on an isolated server and hands you a one-click link into the Administrator as a Super User. It is not literally on localhost, but it delivers the same isolation and the same throwaway freedom, minus the stack. The whole flow is three steps:

1. Pick your versions. Choose Joomla 6.1 or Joomla 5.4, plus a PHP version it supports. There is no stack to download and nothing to configure first.
2. Let the sandbox build the install. A clean, isolated Joomla spins up with the database and configuration already handled. No XAMPP, no MAMP, no MySQL setup.
3. Log in with one click. A private link opens the Joomla Administrator signed in as a Super User. It only needs your email, so there is no long signup form.

It is a real Joomla install, not a locked demo, so you can upload any extension or template, change any setting, and break things on purpose. If XAMPP is the specific habit you are trying to drop, our guide on how to try Joomla without XAMPP covers why a hosted sandbox beats the local stack for a quick test.

Local install or online sandbox: which fits your job?

It depends on how long you need the site and whether you want to own the server. A local install is yours indefinitely and works offline, at the cost of setup and upkeep. An online sandbox is instant and disposable, at the cost of a four-hour life. The table lays out the trade-off across the things that actually differ.

When is a real local install still worth it?

When you need the site to last, to work offline, or to run a custom server configuration. A local install is the right call for a project you develop over weeks, a plane trip with no connection, or a setup where you need a specific PHP extension or a debugger wired in. For those, the setup cost pays for itself, and a four-hour sandbox would just get in your way.

For everything shorter, the maths flips. Vetting one extension, previewing a template, reproducing a client bug, or checking a Joomla update rarely needs a permanent server. Joomla still powers about 1.2% of all websites as of 2026 (W3Techs, usage statistics of Joomla, 2026), so plenty of people hit exactly these short jobs, and a disposable install removes the setup and the cleanup from both ends.

Is there an official way to run Joomla online?

Yes, but it is built for a longer evaluation, not a quick throwaway. The official trial at launch.joomla.org gives you a genuine hosted Joomla maintained by the project, on a subdomain with a 500 MB cap (launch.joomla.org, 2026). The friction is at the door: it asks for your name, email, a password, and phone verification, and the site is persistent, so you log in and renew it every 30 days to keep it alive.

That model suits someone sizing up Joomla over weeks. It is heavier than you want when the job is “open a clean install, try one thing, throw it away.” The demand for a lighter option is not new: a July 2024 request on the Joomla CMS repository asks for “something like wp-playground but for Joomla” to let people try it “without having a server” (joomla/joomla-cms discussion #43744, 2024). An email-only, auto-disposing sandbox fits that job, which is the gap JInstant fills.

Conclusion

Installing Joomla locally is a habit worth questioning. The localhost route works, but it hands you a web server, a database, a download, and an installer to manage, and on Joomla 6 a default XAMPP is too old to even start. Keep it for long-lived or offline projects. When you just need a private, free, clean Joomla to test one thing and walk away, skip the stack: spin up a free Joomla site in your browser, do your thing, and let it delete itself.

Frequently asked questions

Sources

• Joomla Project, Installing Joomla (user manual) (retrieved July 7, 2026).
• Joomla Programmers Documentation, Technical Requirements (retrieved July 7, 2026).
• Apache Friends, XAMPP downloads and bundled versions (retrieved July 7, 2026).
• launch.joomla.org, the official Joomla trial (retrieved July 7, 2026).
• GeeksforGeeks, How to install and set up Joomla on localhost using XAMPP (updated July 23, 2025; retrieved July 7, 2026).
• Open Source Matters, Download Joomla 6.1.0 (released April 14, 2026; retrieved July 7, 2026).
• templaza/astroid-framework, “MAMP Pro on Mac is dead” discussion #654 (retrieved July 7, 2026).
• joomla/joomla-cms, “something like wp-playground but for Joomla” discussion #43744 (July 4, 2024).
• W3Techs, usage statistics and market share of Joomla (retrieved July 7, 2026).