User guide
Everything you need to install, operate, and tune Eliya JDK in production. Organised as a reference: jump to the chapter you need.
Getting started
What is Eliya?
What Eliya is, how it relates to upstream OpenJDK, and the operational-readiness defaults that distinguish it from Corretto, Temurin, and Zulu.
ReadQuick start
Zero to a running Eliya with operational-readiness defaults in five steps. About five minutes end-to-end.
StartInstall on macOS
macOS aarch64 is Phase 2 (next major release, demand-gated). For now, run Eliya in Linux containers locally; SDKman entry for macOS lands with the Phase 2 build.
InstallVerify reproducibility
Rebuild Eliya from published source and confirm byte-identical output. Compliance auditors and supply-chain reviewers.
ReproduceVersioning
What the version string means, the four canonical pin mechanisms, and the formatting exceptions across package formats.
VersioningConfiguration & operations
Flag architecture
Two-layer flag taxonomy: Layer 1 capabilities (boolean) and Layer 2 profile (enum). When to reach for which.
ArchitectureFlags reference
-XX:EliyaProfile=Production breakdown: operational-readiness defaults activated by the profile.
Differences from upstream
Precise enumeration of what Eliya changes vs. upstream OpenJDK 25. Engineer-grade specifics.
Diffasymm CLI
The asymm launcher today; Phase 2+ subcommand surface for diagnostics and operations.
Integrations
Build tooling, Kubernetes, service mesh, logging stacks, CI/CD, APM coexistence, cryptographic providers.
IntegrationsNot sure Eliya is right for you?
Choosing a JDK in 2026: an honest guide
Vendor-by-vendor comparison across Temurin, Corretto, Zulu, Liberica, Oracle, Microsoft, Red Hat, SapMachine, IBM Semeru, GraalVM, and Eliya. Written by us, but honest about when Eliya is not the right pick.
Read the guideReference
Security
Disclosure, advisories, quarterly CPU commitment. Eliya inherits upstream JDK 25 security defaults unchanged, verifiable with diff.
Roadmap
Phase 1 to Phase 4 trajectory: bundled tooling, FIPS variant, Asymm Forensics, compliance-aligned profiles. Demand-gating mechanics.
RoadmapLessons from production
Four production patterns that motivated Eliya's defaults: container memory miscounting, GC pause variance, JVM-blamed-for-upstream-problems, and crashes-preserve-no-evidence.
ReadFAQ
TCK posture, licensing, support, Dial relationship, platform availability: quick answers to the questions evaluators ask first.
FAQ
Eliya 
Dial