Rails application for the Archives Unleashed Cloud.
Switch branches/tags
Nothing to show
Clone or download


AUK; Archives Unleashed Cloud

Build Status codecov Contribution Guidelines LICENSE

King Auk

Rails application for the Archives Unleashed Cloud.



Run the test suite

Ensure Rails is not running (ports 3000), then:

$ bundle exec rake

If you would like to make sure JavaScript files are linted:

$ npm install
$ bundle exec rake

Run a development server

$ rails s

Run the background job

In another command line tab, run the background job with:

bundle exec rake jobs:work

Or to simulate production environment with Delayed::Job:

bin/delayed_job --pool=spark,tasks:1 --pool=graphpass,tasks:1 --pool=seed,tasks:10 --pool=download,tasks:4 --pool=cleanup,tasks:2 --pool=textfilter,tasks:2 start

Then visit http://localhost:3000.

Delayed Job Dashboard

To take advantage of the Delayed Job Dashboard, set the DJW_USERNAME and DJW_PASSWORD in config/application.yml. Then visit http://localhost:3000/jobs.

Retry jobs

If you need to "retry" a stuck or failed job, you can use the "retry" method with a job id (1234):

$ RAILS_ENV=production rails console
Running via Spring preloader in process 19680
Loading production environment (Rails 5.1.4)
irb(main):001:0> Delayed::Job.find(1234).retry!


This application makes use of figaro.

You will need a config/application.yml file in the root of the application.


Set the DASHBOARD_USER and DASHBOARD_PASS in config/application.yml. Then visit http://localhost:3000/dashboards.


To generate a sitemap:

bundle exec rake sitemap:refresh:no_ping

To generate a new sitemap, and submit to Google and Bing, setup a cronjob that runs the following:

bundle exec rake sitemap:refresh

Run a console

You can also run bin/console for an interactive prompt that will allow you to experiment.


Please see contributing guidelines for details.


This application is available as open source under the terms of the Apache License, Version 2.0.


This work is primarily supported by the Andrew W. Mellon Foundation. Any opinions, findings, and conclusions or recommendations expressed are those of the researchers and do not necessarily reflect the views of the sponsors.