Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Build Status


  1. Copy config/secrets.yml.template to config/secrets.yml and add the LDAP and Ezid passwords from Secret Server.

  2. Start PostgreSQL and create new database and a user with login privileges, then add their names to secrets.yml.

  3. Add the credentials for Active Directory and campus LDAP (from Secret Server) to secrets.yml.

  4. Add the Ezid test password (if you don’t have it, email them for it) to secrets.yml.

  5. Add the SRU base URL (currently Pegasus, soon Alma) to secrets.yml.

  6. Ensure Java is installed (brew cask install java), and start Solr and Fedora with bin/wrap (stop them with bin/unwrap).

  7. Run bundle install and CI=1 bin/rake db:migrate. (The CI environment variable disables Marmotta, which we don’t need to run locally.)

  8. Start redis, then a Resque worker with CI=1 VERBOSE=1 QUEUE='*' INTERVAL=5 bin/rake resque:work.

  9. Start the Rails server with CI=1 bin/rails s.

You can run tests with make spec, and HTML documentation by installing yardoc with gem install yardoc then running make html.

Important environment variables

Name Description Required
ADRL_BINARY_ROOT Directory root for local ingest files (defaults to /opt/ingest No
ADRL_DERIVATIVES Directory for ADRL to store IIIF derivatives (defaults to #{Rails.root}/tmp/derivatives) No
ADRL_EMAIL Email address used as sender for form emails No
ADRL_MINTER_STATE Path to minter statefile (defaults to #{Rails.root}/tmp/minter-state No
ADRL_RIIIF_CACHE Directory where RIIIF stores temporary files during derivative creation (defaults to #{Rails.root}/tmp/network_files) No
ADRL_UPLOADS Directory where ADRL stores temporary files during upload to Fedora (defaults to #{Rails.root}/tmp/uploads) No
BRANCH_NAME Branch name or revision for Capistrano to deploy (defaults to master) No
DEV_FEDORA_BASE Path where development Fedora instance is mounted (defaults to /devel) No
DEV_FEDORA_URL Base URL for Fedora service in development mode (defaults to http://localhost:8984/rest) No
DEV_SOLR_URL Base URL for Fedora service in development mode (defaults to http://localhost:8983/solr/development) No
EXPLAIN_PARTIALS Debugging variable; when true, prints view information in rendered source No
FFMPEG_PATH Path to ffmpeg binary (defaults to ffmpeg) No
RAILS_QUEUE How Rails should queue background jobs (e.g., inline, async, resque; defaults to Resque) No
RAILS_SERVE_STATIC_FILES Whether the Rails server should handle requests to public (should be true when not behind a reverse proxy) No
SECRET_KEY_BASE Secret key base for the application Yes
SERVER Server targeted by Capistrano deployment Yes, during deploy
TEST_FEDORA_URL Base URL for Fedora service in test mode (defaults to http://localhost:8986/rest) No
TEST_SOLR_URL Base URL for Fedora service in test mode (defaults to http://localhost:8985/solr/test) No

Ingesting records

See {} and DCE’s wiki:


  • Reindexing all objects (to an empty solr) requires two passes (2.times { ActiveFedora::Base.reindex_everything }). This situtation is not common. The first pass will guarantee that the collections are indexed, and the second pass will index the collection name on all the objects. The object indexer looks up the collection name from solr for speed.


See {}

Some parts of lib/*vocabularies and spec/vocabularies are licensed as follows:

Copyright 2013 Oregon Digital ( Oregon State University & University of
Oregon )
Copyright 2015 Data Curation Experts

Additional copyright may be held by others, as reflected in the commit log

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.