Project

hyrax

0.22
A long-lived project that still receives updates
Hyrax is a featureful Samvera front-end based on the latest and greatest Samvera software components.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Project Readme

Hyrax: A Digital Repository Framework

Samvera's Hyrax Logo

Code: Version CircleCI Code Climate

Docs: Documentation Status API Docs Contribution Guidelines Apache 2.0 License

Jump in: Samvera Community Slack

Table of Contents

  • What is Hyrax?
  • Getting Help and Asking Questions
  • How to Run the Code
  • Contribute
  • Release Process
  • Deploy
  • Acknowledgments
  • License

What is Hyrax?

Hyrax is a Ruby on Rails Engine built by the Samvera community. Hyrax provides a foundation for creating many different digital repository applications.

Note: As a Rails Engine, Hyrax is not a web application. To build your digital repository using Hyrax you must mount the Hyrax engine within a Rails application. We call an application that mounts Hyrax a "Hyrax-based application" (or sometimes a "Hyrax Application").

Hyrax offers the ability to:

  • Create repository object types on demand
  • Deposit content via multiple configurable workflows
  • Describe content with flexible metadata
  • Enable/disable optional features via an administrative dashboard
  • And more (https://hyrax.samvera.org/about/)

Getting Help and Asking Questions

More detailed documentation about Hyrax is available on the Hyrax Github Wiki but if you have questions or need help, please email the Samvera community tech list or stop by the #dev channel in the Samvera community Slack team. You can also get in touch with the Hyrax Maintenance Working Group, including the Hyrax Product Owner and Hyrax Tech Lead.

Reporting Issues

How to Run the Code

Run Hyrax Locally Using Docker

Hyrax can also work running prerequisite dependencies separately. The following describe ways to do this:

Contribute

We'd love to accept your contributions. Please see our guide to contributing to Hyrax.

Installing Analytics

Release Process

See the release management process.

We also have a Maintenance Policy.

Deploy

Steps to deploy a Hyrax-based application to production will vary depending on your particular ecosystem but here are some methods and things to consider:

Acknowledgments

This software has been developed by and is brought to you by the Samvera community. Learn more at the Samvera website.

Samvera Logo

This project is tested with Browserstack.

License

Hyrax is available under the Apache 2.0 license.