Cryostat-legacy is the archived source repository for Cryostat versions up to 2.4.1, containing a container-native JVM application that serves as a bridge to other containerized JVMs. The project explicitly states it is no longer maintained, with active development having moved to the new cryostat repository for version 3.0 and beyond. The application exposes a secure API for producing, analyzing, and retrieving JDK Flight Recorder data from cloud workloads, making it a specialized tool for JVM profiling and observability in containerized environments.
The repository is written in Java and supports deployment across multiple container platforms including Kubernetes, OpenShift, Podman, and Docker. It integrates with container orchestration systems and provides JMX management capabilities for remote JVM monitoring. The project is classified across multiple domains including JDK Flight Recorder management, JVM monitoring, containerized applications, Java profiling, Kubernetes integration, and performance analysis tools.
Build requirements include Git, JDK 17 or later, Maven 3 or higher, and Podman 2.0 or later, with qemu-user-static needed for building container images for different architectures. The project uses Maven for compilation and packaging, with support for building headless versions that exclude web-client assets. Development can be done in hot-reload mode using the devserver.sh script, which starts the Vert.x backend with automatic recompilation on file changes. The cryostat-core library must be installed as a dependency, and web submodules need to be initialized before building.
The application offers extensive configuration through environment variables controlling web server hostname and ports, CORS settings, websocket connection limits, authentication and authorization managers, platform detection strategies, and JDP broadcast settings. Additional configuration options manage automated analysis report generation, JMX connection timeouts, concurrent connection limits, and target cache TTL. The project supports multiple authentication managers and platform strategies, allowing deployment flexibility across different infrastructure setups.
Testing infrastructure includes unit tests via Maven, integration tests, and analysis tools accessible through the verify goal. The repository provides scripts for running integration tests without rebuilding and supports selective test execution. Local development can be performed using podman with the run.sh script, and a smoketest.sh script enables testing with Grafana and a demo application included.
Issue labels tracked include feature requests and build-related items.
Documentation is available at cryostat.io with user guides and tutorials. The project was tagged with hacktoberfest and hacktoberfest2021 topics, indicating community contribution initiatives during those periods.
