JMeter requires Java. That is the only prerequisite. If you have Java 8 or higher installed, you can run JMeter. Let us get it set up.
# Check if Java is installed
java -version
# You should see something like:
# openjdk version "17.0.8" 2023-07-18
# or
# java version "1.8.0_381"
# If Java is not installed:
# macOS: brew install openjdk@17
# Ubuntu: sudo apt install openjdk-17-jdk
# Windows: Download from https://adoptium.net/Go to https://jmeter.apache.org/download_jmeter.cgi
Under "Binaries", download apache-jmeter-5.6.3.zip (or latest version)
Extract the ZIP to a folder. On macOS/Linux: unzip apache-jmeter-5.6.3.zip. On Windows: right-click → Extract All.
The extracted folder contains: bin/ (scripts to run JMeter), lib/ (Java libraries), docs/ (documentation).
Do NOT install JMeter in a path with spaces (e.g., "Program Files"). Use something like C:\jmeter or /opt/jmeter.
# macOS / Linux
cd apache-jmeter-5.6.3/bin
./jmeter.sh
# Windows
cd apache-jmeter-5.6.3\bin
jmeter.bat
# Alternative: double-click jmeter.bat (Windows) or jmeter.sh (macOS/Linux)A Java Swing window opens. It looks old-school, but every performance tester in the world has used this same window. On the left, you see a tree with "Test Plan" at the root. On the right, you see configuration fields. This is your workspace.
JMeter's default memory allocation is too low for real tests. Increase it before you run into "OutOfMemoryError" during a test.
# Find this line in bin/jmeter (Unix) or bin/jmeter.bat (Windows):
HEAP="-Xms1g -Xmx1g -XX:MaxMetaspaceSize=256m"
# Change to (for machines with 8GB+ RAM):
HEAP="-Xms2g -Xmx4g -XX:MaxMetaspaceSize=512m"
# -Xms = initial heap size
# -Xmx = maximum heap size
# Rule of thumb: set -Xmx to 50% of available RAMNever use JMeter GUI for actual load tests. The GUI consumes significant resources to render results in real-time. Use GUI mode only for creating and debugging test plans. Run the actual test in non-GUI (CLI) mode: jmeter -n -t test.jmx -l results.jtl -e -o report/
On macOS, if JMeter opens but the window is blank or tiny, try: java -jar ApacheJMeter.jar from the bin/ directory. Or update your Java to a newer version. JMeter's Swing GUI has quirks on macOS Retina displays.
Key Point: JMeter needs Java 8+. Download, extract, launch with jmeter.sh or jmeter.bat. Increase heap memory for real tests. Use GUI only for building scripts -- run tests in CLI mode.
Key Point: Install: Java 8+ → download ZIP → extract → launch jmeter.sh/bat. Increase heap memory. Use GUI for scripting, CLI for running.