Skip to content

Create New Application Based On Hyrax Docker Image

Randall Floyd edited this page Aug 12, 2025 · 2 revisions

Install New Application Using Hyrax Image

Develop content here...

Maintaining Hyrax Image

We publish several Hyrax images to the GitHub container registry under the Samvera organization. To build them:

export HYRAX_VERSION=v5.0.0 # or desired version
git checkout hyrax-$HYRAX_VERSION

docker build --target hyrax-base --tag ghcr.io/samvera/hyrax/hyrax-base:$(git rev-parse HEAD) .

docker tag ghcr.io/samvera/hyrax/hyrax-base:$(git rev-parse HEAD) ghcr.io/samvera/hyrax/hyrax-base:$HYRAX_VERSION

docker push ghcr.io/samvera/hyrax/hyrax-base:$(git rev-parse HEAD)
docker push ghcr.io/samvera/hyrax/hyrax-base:$HYRAX_VERSION

Do the same for hyrax-worker-base.

We also publish an image for the stable test application dassie:

docker build --target hyrax-engine-dev --tag ghcr.io/samvera/hyrax/dassie:$(git rev-parse HEAD) .

docker tag ghcr.io/samvera/hyrax/dassie:$(git rev-parse HEAD) ghcr.io/samvera/hyrax/dassie:$HYRAX_VERSION

docker push ghcr.io/samvera/hyrax/dassie:$(git rev-parse HEAD)
docker push ghcr.io/samvera/hyrax/dassie:$HYRAX_VERSION

Deploying to Production

Also under development is a Helm chart, which we are developing into a robust, configurable production environment for Hyrax applications.

If you have a Kubernetes cluster configured (kubectl cluster-info), you can deploy the dassie test applications with:

helm dependency update chart/hyrax
helm install -n hyrax --set image.tag=(git rev-parse HEAD) dassie chart/hyrax

Clone this wiki locally