Compatibility Matrix for Java
Supported JVM versions, frameworks and environments for the Hud Java agent.
Verified against java-sdk v0.3.0.
Supported Frameworks
These frameworks are instrumented automatically, with no code changes.
Web frameworks for providing API endpoints data:
| Framework | Framework Versions |
|---|---|
Spring MVC / Spring Boot (spring-boot-starter-web) | 2.3+ — tested on 2.3.9, 2.7.18, 3.5.14 |
Servlet API — javax.servlet and jakarta.servlet | Both namespaces |
| http4k | 6.x — tested on 6.47.1.0 |
Annotated controllers and functional routing (RouterFunctions.route()) are both covered.
The dividing line for Spring is Servlet versus reactive: spring-boot-starter-web is
covered, spring-boot-starter-webflux is not.
Runtime Environment
These are the environments the agent runs in. The requirement is simply that you can add
-javaagent to the JVM's start command.
| Runtime | Supported |
|---|---|
| K8S / Openshift | Yes |
| AWS EKS / App Runner / Beanstalk / EC2 / Fargate / ECS | Yes |
| GCP GKE / Cloud Run / App Engine / Compute Engine | Yes |
| Azure AKS / Container Apps / App Service / Virtual Machines / Container Instances | Yes |
| DigitalOcean Droplets / Kubernetes | Yes |
| External servlet container (Tomcat, Jetty, Undertow) as a WAR | Yes — attach via CATALINA_OPTS / setenv.sh |
| AWS Lambda / GCP Cloud Functions / Azure Functions | Contact us |
| GraalVM native image | No — there is no JVM to attach an agent to |
Supported Runtimes
| Runtime | Runtime Versions |
|---|---|
| Java | 8, 11, 17, 21, 25 |
Supported Servers
| OS | CPU's |
|---|---|
| Linux | x64, arm64 |
| MacOS | Apple Silicon, Intel |
| Windows | Not supported — blocked by default; the agent will not start |
A Linux container running on a Windows host is fine — it is the JVM's operating system that
is checked, not the machine's.
Supported IDEs
| IDE | IDE Version | Supported OS |
|---|---|---|
| JetBrains Suite | 2023.2+ | MacOS |
| Visual Studio Code | 1.1.1+ | MacOS |
| Cursor | 1.1.1+ | MacOS |
Updated 9 minutes ago
What’s Next
You're now familiar with the technical stack required for working with the Hud agent on the JVM. For any issues or compatibility questions, contact us at [email protected].