Join our team! We are hiring a Senior Software Developer!
Download Hyrax-1.17.1
Hyrax is open source, giving you the flexibility to choose how you install and run it. We use continuous integration and continuous delivery (CI/CD) to build our software for every change of the source code.
Citing Hyrax 
To cite Hyrax-1.17.1 use the following:
James Gallagher, Dan Holloway, Nathan Potter, Kodi Neumiller, Sam Lloyd, ies-uri, Slav Korolev, Doug Newman, Lewis John McGibbney, & Miguel Jimenez. (2025). Hyrax-1.17.1. Zenodo. https://doi.org/10.5281/zenodo.14660548
Broadly, Hyrax-1.17.1 is comprised of
- OLFS-1.18.15
- BES-3.21.1
- libdap-3.21.1
- ncWMS2 (optional).
Jump to download options by selecting from the installation options below:
What’s New?
The new release of Hyrax contains many improvements to the DMR++ build, generation and testing process, as well as a broader coverage for many of NASA’s HDF4 / HDF4-EOS2 / HDF5 datasets. In particular, the scripts to generate DMR++ have major improvements in performance, with better testing, checks, and improved documentation on how to generate the DMR++ files and map the variables inside these files to the mature and broadly used OPeNDAP DAP4 protocol.
In this new version of Hyrax, DMR++ now supports a wide range of HDF5, HDF4, and HDF4-EOS2 features, allowing for direct data access in the cloud for many of NASA’s datasets. This means that DMR++ files can be generated for a wide range of NASA’s datasets, including those that may have missing grid information. The DMR++ software includes better support for DAP4, including mapping HDF4 Grids to DAP4 Groups and dimensions. When CF grid variables are missing, these grid variables are generated and embedded in the DMR++. In addition to more complete support for these archival data file formats, various optimizations to the dmrpp generator have been included to improve the generation, checks, and testing of DMR++.
DMR++ increases its support for HDF5 by supporting (compressed) compound data types, arrays of strings, and subsetting of HDF5 compact arrays. In addition, there are various fixes to how DMR++ reads variable string data. Lastly, this release provides a fix to reported issues when building DMR++ from NetCDF-4 datasets with enable-CF option set true.
Some minor fixes to Hyrax’s HDF5 handler are incorporated in the new version, along with an improved testsuite. Hyrax’s HDF4 handler is greatly expanded to directly support the DAP4 protocol for NASA’s HDF4 and HDF4-EOS2 datasets. Previously, DAP4 support was available by translating the DAP2 objects, which meant important features of DAP4 were not available. This new ‘native’ DAP4 implementation continues to support CF grids/variables and the default options of the older software. Finally, the overall performance of the HDF4 handler has been improved resulting in shorter response times.
Various fixes are now incorporated to Hyrax to improve performance and support for DAP4 and DAP4 to DAP2 mappings for various NetCDF cases. Lastly, a better handling of BES Error types and exception cases and improvements to the BESLog has been implemented resulting in more meaningful error messages and timing data for BES commands.
For those with NASA access to JIRA, see the completed issue list for this release: NASA JIRA
1) Docker Images
Simplest way to deploy Hyrax as it eliminates compatibility issues with your operating system and other software by creating a self-contained environment. You only need the Docker software itself, available for Mac, Windows, and Linux. There are various images options to choose from:
- Hyrax – The complete Hyrax service in a single Docker image. Use the tag latest to install the official release version Hyrax-1.17.0, or use the tag snapshot to install the absolute-latest version which includes the latest commits to master branch. Both options are fully tested by Travis as part of the CI/CD process.
- Hyrax with ncWMS2 – (optional) The Hyrax service bundled with ncWMS2 in a single Docker image.
- Full list of Snapshot docker images. These builds are pushed to our Docker Hub site and as part of the CI/CD process.
The Docker image installation and configuration instructions can be found on the Hyrax guide. It also explains how to configure the docker images for various common data distribution cases.
2) Linux Binaries
This requires manual installation of pre-compiled libraries for Linux (RHEL-8) available below.
Required external dependencies:
- Java >= 17
- Tomcat >= 9
OLFS
- OLFS 1.18.15 Web Archive File (gpg signature)
- OLFS Automatic robots.txt generation for 1.18.15 (gpg_signature) This archive contains a web archive file that runs in the Tomcat server’s root context that returns a response for ‘/robots.txt’ so that your site can be crawled using the automatically-built site maps added in 1.15.2. This is beta software; we’d appreciate feedback on it.
ncWMS2 (optional)
- Use the EDAL web page to locate the latest ncWMS2 “Servlet Container” software bundle as a WAR file. Install it into the same Tomcat instance as the OLFS. The configuration instructions may be found here.
BES and libdap
Linux (RHEL-8) x86_64 RPMs Our Enterprise Linux builds are released on el8 (using rocky-8)
- libdap-3.21.1-0 (gpg signature).
- bes-3.21.1-0.static (gpg signature) – This RPM includes statically linked copies of all of the modules/handlers we support, including HDF4 & 5 with HDF-EOS support. There is no need to install packages from EPEL with this RPM. Other sources of RPM packages will likely provide a bes RPM that uses handlers linked (dynamically) to dependencies from their distributions (CentOS, Fedora, etc.).
The instructions for installing the pre-compiled binaries and testing the server can be found on the Hyrax Guide.
3) Source Code
The complete source code is available for developers who want to customize Hyrax for their specific needs. There are two ways to get the source code:
3a) Source binaries for Hyrax 1.17.1
- libdap-3.21.1, gpg signature.
- bes-3.21.1, gpg signature.
- Collected dependencies for Hyrax 1.17.1 (gpg signature) – This bundles the NetCDF, HDF4, HDF5, and other libraries that the Hyrax handlers require. Note that for Hyrax-1.17.1 with Direct I/O for some netCDF4 file responses, you need this when building from source because we use a special version of netCDF not publically available.
3b) Source from GitHub
- All of our source code is available at our GitHub site. There you will find the hyrax project repository, which is a meta-project that contains scripts to clone and build all of Hyrax. You will also see all of the repos that contain the Hyrax source code (libdap4, the BES and all of its handlers, and the OLFS).
Directions on building Hyrax from GitHub are described on the Hyrax Guide..