How to Install JMeter on Mac?

The quickest way to install JMeter on a Mac is Homebrew: run brew install jmeter, then type jmeter in Terminal to open it. Homebrew installs Apache JMeter 5.6.3 together with its own Java (OpenJDK 21) and the JMeter Plugins Manager, so there is nothing else to set up. The alternative is to download the archive from jmeter.apache.org, install Java 8 or newer yourself and start bin/jmeter. Both routes work on Apple Silicon and Intel Macs.

Key takeaways

• brew install jmeter is the shortest path: one command, Java included, and brew upgrade jmeter keeps it current.
• The archive download suits you when you need a specific JMeter version or several versions side by side.
• Most install problems on a Mac are a missing Java or a Homebrew that is not on your PATH.

How to install JMeter on Mac with Homebrew

Homebrew is the package manager most Mac developers already use. If you do not have it yet, these steps take about five minutes.

1. Check for Homebrew. Open Terminal and run brew -v. A version number means you can skip to step 3.

2. Install Homebrew. Run the installer from brew.sh:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

   On an Apple Silicon Mac, Homebrew lives in /opt/homebrew and has to be added to your shell. The installer prints the exact lines; for the default zsh shell they are:

   echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
   eval "$(/opt/homebrew/bin/brew shellenv)"

3. Install JMeter.

   brew install jmeter

   This also pulls in openjdk@21, which JMeter uses through its own wrapper script, so it does not matter which Java (if any) the rest of your Mac uses.

4. Check the version.

   jmeter -v

   You should see the JMeter banner with version 5.6.3.

5. Open JMeter. Type jmeter and the GUI starts.

The old brew install jmeter --with-plugins command no longer works, because Homebrew removed formula options. You do not need it: the Homebrew formula already places the Plugins Manager in JMeter’s lib/ext folder, so you will find it under Options > Plugins Manager. Our guide to installing plugins with the JMeter Plugins Manager takes it from there.

Where Homebrew installs JMeter on Apple Silicon and Intel Macs

Homebrew’s prefix depends on the processor: /opt/homebrew on Apple Silicon (M1 and later) and /usr/local on Intel Macs. JMeter itself sits under libexec inside its formula folder, and this command prints the right path on either kind of Mac:

echo "$(brew --prefix jmeter)/libexec/bin"

That bin folder holds jmeter.properties, user.properties and the other configuration files. Put your own settings in user.properties rather than editing jmeter.properties, and keep a copy: brew upgrade installs each new version into a fresh folder. There is more on this in where to find JMeter’s configuration files with Homebrew.

How to install JMeter on Mac from the archive (no Homebrew)

Use this route when you need a specific JMeter version or do not want Homebrew.

1. Check Java. Run java -version. JMeter 5.6.3 needs Java 8 or newer, and a full JDK is better than a JRE because recording HTTPS needs the JDK’s keytool. If macOS says no Java runtime is installed, install a JDK first (any current OpenJDK build works, for example brew install openjdk@21).

2. Download JMeter. On the Apache JMeter download page, take the binary apache-jmeter-5.6.3.tgz (or the .zip).

3. Extract it where you want JMeter to live:

   tar -xzf ~/Downloads/apache-jmeter-5.6.3.tgz -C ~

4. Start it.

   ~/apache-jmeter-5.6.3/bin/jmeter

5. Add it to your PATH so jmeter works from any folder. Add this line to ~/.zshrc, then open a new Terminal window:

   export PATH="$HOME/apache-jmeter-5.6.3/bin:$PATH"

If you installed Java through Homebrew and JMeter cannot find it, point JAVA_HOME at it. The jmeter script reads JAVA_HOME, and when it is empty it asks macOS’s /usr/libexec/java_home to guess:

export JAVA_HOME="$(brew --prefix openjdk@21)/libexec/openjdk.jdk/Contents/Home"

How to open JMeter on Mac from Terminal

• Homebrew install: type jmeter.
• Archive install: run bin/jmeter from the JMeter folder, or just jmeter once it is on your PATH. Use bin/jmeter, not jmeter.sh; the manual describes jmeter.sh as a very basic script.
• Open a specific test plan: jmeter -t my_test.jmx.
• Run a test without the GUI: jmeter -n -t my_test.jmx -l results.jtl. The GUI is for building plans; real load tests belong on the command line, as our guide to running JMeter in non-GUI mode explains.

Common JMeter install errors on Mac and how to fix them

• zsh: command not found: brew after installing Homebrew on Apple Silicon: the brew shellenv lines from step 2 are missing from ~/.zprofile.
• Error: invalid option: --with-plugins: drop the option and install the plugins from the Plugins Manager instead.
• “Unable to locate a Java Runtime” with an archive install: no JDK is installed, or JAVA_HOME points at a folder that no longer exists. Install a JDK and set JAVA_HOME as shown above.
• zsh: command not found: jmeter with an archive install: the bin folder is not on your PATH, or you edited ~/.zshrc and did not open a new Terminal window.
• JMeter runs out of memory on a large plan: the default heap is 1 GB. Raise it in bin/setenv.sh (for example export HEAP="-Xms1g -Xmx4g -XX:MaxMetaspaceSize=256m"); increasing heap size in JMeter has the details.

After the install: run the same test in the cloud

A Mac is a good place to build and debug a test plan, and a poor place to generate serious load, since one laptop runs out of CPU and network long before your server does. When the plan works, you can upload the same .jmx file and its CSV data to LoadFocus JMeter cloud load testing and run it from 25+ cloud regions without setting up load generators.

Frequently Asked Questions

How do I update JMeter installed with Homebrew?

Run brew update and then brew upgrade jmeter. The new version goes into a fresh folder under Homebrew’s prefix, so copy any edited user.properties or setenv.sh across after the upgrade.

How do I uninstall JMeter from my Mac?

For a Homebrew install, run brew uninstall jmeter, and brew autoremove if you also want to remove the OpenJDK it pulled in and nothing else uses. For an archive install, delete the apache-jmeter-x.y.z folder and remove its line from ~/.zshrc.

Does Homebrew’s JMeter work on Apple Silicon (M1, M2, M3, M4)?

Yes. JMeter is a Java application, and Homebrew’s package for it works on both Apple Silicon and Intel Macs. The only difference you will notice is the install prefix: /opt/homebrew on Apple Silicon and /usr/local on Intel.

Can I install multiple versions of JMeter on the same Mac?

Yes, with archive installs. Extract each version into its own folder, for example ~/jmeter/5.5 and ~/jmeter/5.6.3, and run the one you need by its full path, or switch your PATH between them. Homebrew only offers the current JMeter release.

Which Java version does JMeter need on Mac?

JMeter 5.6.3 is compatible with Java 8 or higher. A Homebrew install brings OpenJDK 21 with it; for an archive install, any current JDK works, and the JMeter project recommends the latest minor release of whichever major version you use.

How do I check which JMeter version is installed?

Run jmeter -v in Terminal. It prints the JMeter banner and version number without opening the GUI.

How do I increase JMeter’s memory on Mac?

Create bin/setenv.sh in the JMeter folder and set HEAP, for example export HEAP="-Xms1g -Xmx4g -XX:MaxMetaspaceSize=256m". The jmeter script reads this file every time it starts.

Can I integrate JMeter with CI/CD tools?

Yes. Any CI system that can run a shell command can run JMeter in non-GUI mode and keep the results file or HTML report as a build artifact. Jenkins also has a Performance plugin that reads JMeter results and can fail a build on thresholds.

Sources

• Apache JMeter, download page (version 5.6.3, “Requires Java 8+”), read 23 October 2026.
• Apache JMeter user manual, Getting Started (Java requirement, bin scripts, HEAP and setenv.sh), read 23 October 2026.
• Homebrew, jmeter formula and its source in homebrew-core (version 5.6.3, openjdk@21 dependency, Plugins Manager placed in lib/ext), read 23 October 2026.
• Homebrew documentation, Installation (install command, /opt/homebrew and /usr/local prefixes, brew shellenv), read 23 October 2026.
• JMeter Plugins, Plugins Manager (installed in lib/ext, opened from the Options menu), read 23 October 2026.

Related reading

• JMeter Homebrew Error: invalid option with-plugins
• Create an Alias to Start JMeter Locally
• JMeter Load Testing Tutorial: Local, Distributed, Cloud

Run this JMX in the cloud, from 25+ regions

Upload your JMeter script to LoadFocus and run it with thousands of virtual users from 25+ cloud locations, with no load generators to manage. Results show p95/p99 response times, throughput and errors per request, and a free tier is included.

JMeter Cloud Load Testing

Free API Load Test