guitarrapc/jmeter-gui repository overview

⁠docker-jmeter-gui

Run Apache JMeter⁠ GUI in a Docker container and connect via browser.

Find Images on Docker Hub⁠.

⁠Featured Tags

• latest⁠, 5⁠, 5.6⁠, 5.6.3⁠ (Ubuntu 24.04 based)
  • docker pull guitarrapc/jmeter-gui:5.6.3
• 5-alpine3.23⁠, 5.6-alpine3.23⁠, 5.6.3-alpine3.23⁠ (Alpine 3.23 based)
  • docker pull guitarrapc/jmeter-gui:5.6.3-alpine3.23
• 5.3⁠ (Alpine based - legacy, require VNC or RDP client)
  • docker pull guitarrapc/jmeter-gui:5.3

⁠Motivation

Apache JMeter is a GUI-based performance testing tool, but setting up the runtime environment can be challenging.

• Java dependency: Requires specific JDK versions and environment configuration
• Platform differences: Behavior may vary across operating systems
• Installation overhead: You may not want to install JMeter directly on your host machine

This Docker image solves these problems by providing JMeter GUI in a containerized environment with browser-based access.

• Browser-based operation: Access JMeter GUI directly from your web browser using KasmVNC - no VNC/RDP client installation required
• Zero client setup: Operate JMeter GUI from any OS with just a web browser
• Cross-platform support: Available on both Ubuntu 24.04 and Alpine 3.23 base images
• Easy file sharing: Mount host directories to create and save .jmx scenario files
• Clean environment: Keep your host system clean without installing Java or JMeter
• Consistent behavior: Ensure identical operation across different platforms

⁠Usage

⁠Using Docker Run

Run the container with your scenario directory mounted:

docker run -itd --rm -v ${WORK_DIR}/:/root/jmeter/ -p 8080:8080 guitarrapc/jmeter-gui:latest

• Port 8080: Browser-based access
• Available variants:
  • guitarrapc/jmeter-gui:5.6 (Ubuntu 24.04 based)
  • guitarrapc/jmeter-gui:5.6.3-alpine3.23 (Alpine 3.23 based)

⁠Using Docker Compose

See the samples⁠ directory for a complete example.

cd samples
docker compose up

⁠Connecting to JMeter GUI

This image uses KasmVNC(Ubuntu) or noVNC (Alpine) for browser-based access.

1. Start the container using Docker run or Docker Compose
2. Open your web browser
3. Navigate to: http://localhost:8080
4. JMeter GUI will be accessible directly in your browser

This approach works on any operating system (Windows, macOS, Linux) without additional software.

⁠Working with JMeter

JMeter GUI is automatically launched when the container starts.

Configure your JMeter test scenarios using the GUI.

Save your scenario files (.jmx) to the mounted volume (/root/jmeter in the container) to access them from your host.

⁠Build

To build the Docker image locally.

docker build -t jmeter-gui:5.6.3-ubuntu24.04 -f ./src/ubuntu24.04/Dockerfile src/ubuntu24.04/
docker build -t jmeter-gui:5.6.3-alpine3.23 -f ./src/alpine3.23/Dockerfile src/alpine3.23/

Run your locally built image.

docker run -it --rm -v ${PWD}/scenarios:/root/jmeter/ -p 8080:8080 jmeter-gui:5.6.3-ubuntu24.04
docker run -it --rm -v ${PWD}/scenarios:/root/jmeter/ -p 8080:8080 jmeter-gui:5.6.3-alpine3.23

⁠Version Information

• Base Image: Ubuntu 24.04, Alpine 3.23
• JMeter: 5.6.3
• JMeter Plugins Manager: 1.10

⁠License

This project is licensed under MIT License.