How to Install JMeter on Windows 10

Apache JMeter is a free, open-source tool for load testing websites, APIs and other services. It simulates many users at once so you can see how your application performs under pressure. JMeter doesn’t have a traditional installer. You install Java, download a ZIP file, extract it, and run a batch file.

This guide walks through each step on Windows 10, including the optional environment variables, how to launch the GUI and command-line modes, and fixes for the errors people hit most often.

What You Need

• Windows 10 or Windows 11.
• Java 8 or later. The Apache JMeter project says JMeter is compatible with Java 8 or higher, and recommends a JDK rather than a JRE because recording HTTPS traffic needs the JDK’s keytool utility.
• About 100 MB of free disk space, plus room for test results.

How to Install JMeter on Windows 10

Step 1: Install Java

Download a current long-term support JDK, such as JDK 21, from Oracle or from an OpenJDK distribution like Eclipse Temurin or Microsoft Build of OpenJDK. Run the installer and accept the defaults. Our guide on how to install the JDK on Windows 10 covers this step in detail. To confirm it worked, open Command Prompt and type java -version. You should see a version number. If you get “not recognized,” see the troubleshooting section.

Step 2: Download JMeter

Go to the Apache JMeter download page and, under Binaries, download the .zip file for the latest release (for example, apache-jmeter-5.6.3.zip). Don’t download the “_src” file, which is source code.

Step 3: Extract the ZIP

Right-click the ZIP, choose Extract All, and extract it to a short path without spaces, such as C:\JMeter. Avoid Program Files, because JMeter writes logs and results inside its own folder and Program Files can block that.

Step 4: Set environment variables (optional)

JMeter runs without this step, but it lets you start JMeter from any Command Prompt window. If you haven’t edited these before, see how to set environment variables in Windows 10.

1. Search Start for Edit the system environment variables and open it.
2. Click Environment Variables.
3. Under System variables, click New. Set the name to JMETER_HOME and the value to your folder, such as C:\JMeter\apache-jmeter-5.6.3.
4. Select Path, click Edit, then New, and add %JMETER_HOME%\bin.
5. Click OK on every window and open a new Command Prompt.

If Java isn’t found later, also add a JAVA_HOME variable pointing to your JDK folder, such as C:\Program Files\Java\jdk-21.

Step 5: Launch JMeter

Open the bin folder and double-click jmeter.bat. If you set the Path variable, you can also type jmeter in Command Prompt. A console window opens first, followed by the JMeter GUI. Keep the console window open while you work, because closing it closes JMeter.

Run a Test from the Command Line

The GUI is meant for building and debugging tests. For real load tests, the JMeter project recommends non-GUI mode, which uses far less memory. A typical command is:

jmeter -n -t mytest.jmx -l results.jtl -e -o report

This runs the test plan, saves raw results, and builds an HTML dashboard in the report folder. The JMeter Getting Started guide lists every command-line option.

Add Plugins with the Plugins Manager

Many testers add the free JMeter Plugins Manager, which installs extra listeners, samplers and graphs. Download the plugins-manager JAR from jmeter-plugins.org, copy it into JMeter’s lib\ext folder, and restart JMeter. A new Plugins Manager item appears in the Options menu.

Troubleshooting

• “java is not recognized as an internal or external command.” Java isn’t on the Path. Reinstall the JDK with the option to set PATH, or add JAVA_HOME and %JAVA_HOME%\bin to the Path manually.
• The window flashes and closes. Run jmeter.bat from Command Prompt instead of double-clicking, so you can read the error.
• Out of memory errors. Edit bin\jmeter.bat and raise the heap size in the line that sets HEAP, for example to -Xms1g -Xmx4g, or use non-GUI mode for big tests.
• Blurry or tiny interface on high-DPI screens. Change the zoom under Options > Zoom In, or adjust Windows display scaling.
• HTTPS recording fails. You’re using a JRE without keytool. Install a full JDK.

Tips

• Keep each JMeter version in its own folder so you can upgrade by extracting the new ZIP alongside the old one.
• Save test plans (.jmx files) outside the JMeter folder so they survive upgrades.
• Close GUI listeners like View Results Tree during load tests, since they slow JMeter down.
• Working with other Java tools? See how to open a JNLP file in Windows 11.

Frequently Asked Questions

What is JMeter used for?

Load and performance testing of web applications, APIs, databases and other services, plus some functional testing.

Does JMeter need to be installed?

Not in the usual sense. You extract the ZIP and run it, as long as Java is installed.

Which Java version should I use?

Java 8 is the minimum. A current LTS JDK, such as 17 or 21, is a good choice.

Is JMeter free?

Yes. It’s open source under the Apache License 2.0.

Does it work on Windows 11?

Yes. The steps are the same.

Wrapping Up

Install a JDK, download the JMeter ZIP from Apache, extract it to a simple folder, and run jmeter.bat from the bin folder. Add JMETER_HOME to your Path if you want to launch it from anywhere, and use non-GUI mode for real load tests.

Related: how to install SQLite on Windows 10.