Getting Started

UTEM (Universal Test Execution Monitor) is a self-hosted, real-time test reporting dashboard. It receives test events from your CI pipeline and displays live results, trends, and analytics in a web UI.

How It Works

Your tests  →  UTEM Reporter  →  UTEM Server  →  Dashboard
(JUnit/Cucumber)   (sends HTTP events)   (stores + streams)   (React UI)

1. UTEM Server runs as a Spring Boot app (JAR or Docker)
2. UTEM Reporter is a test listener added to your project
3. Reporter sends events (test started, passed, failed) to the server via HTTP
4. Dashboard shows live results via WebSocket

Quick Start

1. Start the server

java -jar utem-core-0.9.2.jar

Open http://localhost:8080 — the dashboard is ready.

2. Create a project

Go to Projects → + New Project. Copy the generated API key.

3. Add the reporter

Add to your pom.xml:

<dependency>
  <groupId>com.utem</groupId>
  <artifactId>utem-reporter-junit5</artifactId>
  <version>0.9.2</version>
  <scope>test</scope>
</dependency>

Configure in src/test/resources/utem.properties:

utem.server.url=http://localhost:8080
utem.api.key=utem_your_api_key_here
utem.run.name=My Test Suite

4. Run your tests

mvn test

Your test run appears live in the dashboard.

Next Steps

• Installation options — JAR, Docker, start.bat
• Configuration reference — all properties
• Enable authentication — multi-user setup
• JUnit 5 reporter — detailed setup
• Cucumber reporter — Cucumber integration
• TestNG reporter — Java TestNG projects
• Jest reporter — JavaScript/TypeScript projects
• Cypress reporter — Cypress E2E
• Playwright reporter — Playwright E2E
• pytest reporter — Python projects