How to Install and Run latest Hyrax

This is the first of a series of posts that describe “How to“… when using OPeNDAP’s Hyrax Data Server.

Objectives

• Install and run the latest version of OPeNDAP’s Hyrax data server.

Prerequisites

• Some data stored locally (~/tmp/DATA/).
• Docker deamon running in background (“Docker Desktop“).
• MacOS or Linux (we currently do not test our software with Windows).

Run Hyrax

This is a 2-step process.

1. Open a terminal window on your Desktop computer and pull the latest tag of Hyrax:

docker pull opendap/hyrax:latest
  

2. Now, if you are running this tutorial on a Linux environment, run the following command

docker run -d -h hyrax -p 8080:8080 \
--volume ~/tmp/DATA:/usr/share/hyrax \
--name=hyrax opendap/hyrax:latest
  

NOTE: If you are running this tutorial on a MacOS with an M-chip, you will need to add the following line to the docker run command above:

--platform linux/amd64 \
  

Now, you can inspect the “landing page” of your own Hyrax instance on http://localhost:8080/opendap/.

Check the tutorial video associated with this post: