BlazeMeter Environment Manager

This guide provides step-by-step instructions to install, configure, and use the BlazeMeter Environment Manager for managing JMeter testing environments.

Why use an environment manager?

The BlazeMeter Environment Manager is a desktop application that helps you create, manage, and launch consistent local Apache JMeter® environments. It provides curated JMeter and Java distributions maintained by BlazeMeter and simplifies local test authoring, validation, and troubleshooting. It also delivers updated Apache JMeter versions, JMeter plugins (including BlazeMeter-developed plugins), and Java JDK distributions, helping ensure that your test environments remain both up to date and secure.

BlazeMeter Environment Manager allows you to:

  • Manage multiple Java and JMeter versions

  • Use updated and curated distributions of Java JDK, Apache JMeter, and JMeter plugins (including plugins developed by BlazeMeter)

  • Benefit from the JMeter distribution created by Blazemeter, which includes security fixes not available in the official Apache JMeter releases

  • Create isolated JMeter environments

  • Launch JMeter with consistent, predefined configurations

This helps ensure repeatability and consistency across performance testing activities.

Supported providers and system requirements

The BlazeMeter Environment Manager supports the following JMeter and Java versions and distributions:

JMeter versions

  • Apache JMeter 5.5

  • Apache JMeter 5.6.3

These versions are bundled and validated by BlazeMeter.

Java distributions

  • Zulu (Azul)

  • Temurin (Adoptium)

  • Corretto (Amazon)

Java versions

  • Java 8

  • Java 11

  • Java 17

System requirements

Ensure your machine meets the following specifications:

  • Operating system: macOS 11+, Windows 10+

  • Minimum 4 GB RAM

  • At least 2 GB free disk space

  • Internet access for downloading JMeter and Java bundles

Install the BlazeMeter Environment Manager

Download and run the latest installer for your operating system:

For macOS:

  1. Download the .zip file from the downloads page

  2. Decompress the .zip

  3. Open the .app

  4. If prompted, allow the app in System Settings > Security & Privacy

For Windows:

  1. Download the .exe installer from the downloads page

  2. Run the installer and follow the on-screen instructions

  3. Launch the application from the Start Menu or desktop shortcut

Create and manage environments

Create a new environment

To create a JMeter environment:

  1. Launch the BlazeMeter Environment Manager.

  2. Click the + (Create) button.

  3. Enter environment details (all fields are required):

    • Name: Give a descriptive environment name

    • Description: Enter optional context or purpose

    • Java Version: Select a JDK distribution and version

    • JMeter Version: Select a JMeter version

  4. Click Create Environment.

Notes:

  • Required bundles are downloaded automatically if not already present.

  • Environments are stored locally on your machine.

    • macOS: ~/.blazemeter-environment-manager/environments/

    • Windows: %APPDATA%\.blazemeter-environment-manager\environments\

  • Environment folders can be copied between systems if needed. Existing environments can be used while offline, but Internet access is required to create new environments or download new bundles.

Manage existing environments

All environments appear in the main environment table.

You can:

  • Start (▶): Launch JMeter GUI using the environment

  • Edit: Change Java, JMeter, or JVM settings

  • Open Folder: Access the local environment directory

  • Delete: Remove the environment from your system

Configure JVM settings

Each environment has its own JVM configuration. To access it:

  1. Select an environment.

  2. Select Edit.

  3. Navigate to the JVM Configuration tab.

Available JVM settings

Setting Description Example
Heap Size Memory allocated to Java 2g, 512m
GC Algorithm Garbage collector to use G1GC (recommended for Java 11+)
JVM Arguments Additional Java options -Dproperty=value

These settings are applied every time JMeter is launched from the environment.

Common issues and troubleshooting

Application does not start

Workaround: For macOS, allow the app in System Settings > Security & Privacy. For Windows, run the application as administrator.

JMeter does not launch when prompted

Workaround: Verify Java and JMeter bundles have completed downloading, check available disk space, and try deleting and recreating the environment.

Download failures

Workaround: Check internet connectivity, verify firewall or proxy settings, and retry if the download service is temporarily unavailable.

Environment creation fails

Workaround: Verify a stable Internet connect, ensure at least 2 GB of free disk space, and confirm that Java and JMeter versions are selected.

For other issues, contact BlazeMeter Support.