Dive into Hydra Works

Bess Sadler edited this page Jan 25, 2017 · 14 revisions

warning Warning: The Hydra:Works API is under active development. It may have changed since the last update to this tutorial.

This tutorial is tested to work with the following versions of hydra and hydra works

gem 'hydra', '11.0.0'
gem 'hydra-works', '0.15.0'

Please update this wiki to reflect any other versions that have been tested.


This tutorial assumes that you have some basic familiarity with Ruby and Rails. If you are new to Rails, we recommend going through the RailsBridge Tutorial first.

A fun way to learn about the basic Rails syntax and patterns is the Rails for Zombies tutorial.

The tutorial also mentions using Ruby Version Manager, a.k.a RVM. Before starting this tutorial, visit the RVM website to learn about how that tool is used. RVM is not required in order to do the tutorial, but you will probably find it useful.

System Requirements

Your system should have the following installed to successfully complete this tutorial:

Note: these requirements are specific to this tutorial, please check the Hydra README.md for additional version compatibility information.


  • Create a working Hydra Head
  • Get development instances of Solr & Fedora installed and running
  • Start & Stop the development instance of the Application
  • Define Models for Content to put into your Hydra Head (in this case Bibliographic Works and Pages)
  • Use your Models to Create objects in Fedora and Solr
  • See where content is persisted in Fedora and indexed in Solr
  • Modify how metadata is indexed in Solr
  • Start Using Git to Track Code Changes


  1. Lesson: Generate a Rails Application
  2. Lesson: Add the Hydra Dependencies
  3. Lesson: Start FCRepo and Solr
  4. Lesson: Start the Application & Search for Results
  5. Lesson: Define models with Hydra-Works
  6. Lesson: Create instances of Hydra-Works models
  7. Lesson: Explore Objects in Fedora and Solr
  8. Lesson: Make Blacklight Return Search Results


You've completed the main tutorial, the following lessons can be completed in any order based on your interests:

  1. Lesson: Add pages to a bibliographic work
  2. Lesson: Add attached files
  3. Lesson: Generate Rails Scaffolding for Creating and Editing

Next Steps

You've finished the initial Hydra tutorial and learned about setting up the basic hydra framework and building basic data models with Hydra-Works provided in a default hydra install. There is still lots more to learn. At this point, you can explore the ideas in this tutorial further by spending some time building out your models to support more complex metadata, further customizing your application views, and/or adding tests to make your applications more robust and easy to maintain.

There are additional tutorials for Hydra without Hydra-Works that have not yet been tested with Hydra-Works. See the Bonus and Nest Steps tutorials at Hydra wiki - Dive into Hydra

  • Even though the information there is not specific to Hydra, Getting Started with Rails is a great place to learn more about Model, View, and Controller conventions within Rails that can be applied to building your own Hydra-based repository.

You should also say hello on the hydra-tech mailing list and let us know what you're using Hydra for.

Check out the Hydra Project Website at http://projecthydra.org

Project Hydra Logo

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.