How to Install Samvera Hyrax on Debian Latest

Samvera Hyrax is an open-source digital repository management system used to create, manage, and preserve digital collections. In this tutorial, we will go through the process of installing Samvera Hyrax on Debian latest.

Prerequisites

Before we begin, ensure you have the following:

• A Debian latest server with root access
• A non-root user with sudo privileges
• Java 8 or higher version
• Ruby 2.6 or higher version
• SQLite or PostgreSQL database

Step 1: Install Required Dependencies

First, we need to install some dependencies that are required for Samvera Hyrax. Run the following command to install them:

sudo apt-get update
sudo apt-get install build-essential libssl-dev libffi-dev libxml2-dev libxslt1-dev libpq-dev libsqlite3-dev git curl zip unzip

Step 2: Install RVM (Ruby Version Manager)

You can install RVM to manage your Ruby versions. Run the following command to install RVM:

curl -sSL https://get.rvm.io | bash -s stable

After installing RVM, you need to activate it by running the following command:

source /etc/profile.d/rvm.sh

Step 3: Install Ruby Version 2.6 or Latest

Next, install Ruby version 2.6 or higher by running the following command:

rvm install 2.6.3

After installing Ruby, set it as the default by running:

rvm use 2.6.3 --default

Step 4: Install Node.js

Install Node.js by running the following command:

sudo apt-get install nodejs

Step 5: Install Yarn

Install Yarn by running:

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt-get update && sudo apt-get install yarn

Step 6: Install ImageMagick

Install ImageMagick with the following command:

sudo apt-get install imagemagick

Step 7: Install Samvera Hyrax

Now, it's time to install Samvera Hyrax. Run the following command to install it:

gem install hyrax

Step 8: Generate Hyrax Initializer

You need to generate the hyrax initializer by running:

rails generate hyrax:install

This will create the Hyrax initializer files in the config/initializers/hyrax.rb directory.

Step 9: Setup the Database

You can choose either SQLite or PostgreSQL for the database. In this case, we will use SQLite. To configure the database, run the following commands:

echo 'production:
  adapter: sqlite3
  encoding: unicode
  database: db/production.sqlite3
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
  timeout: 5000' > config/database.yml

After that, run the following command to create the database:

RAILS_ENV=production bundle exec rake db:create
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake hyrax:default_collection_types:create
RAILS_ENV=production bundle exec rake hyrax:workflow:load

Step 10: Start the Server

Finally, start the server with the following command:

RAILS_ENV=production bundle exec rails server -d

You can then access Samvera Hyrax by going to http://localhost:3000 in your web browser.

Conclusion

In this tutorial, you learned how to install Samvera Hyrax on Debian latest. You now have a working digital repository management system that can be used to create, manage, and preserve digital collections.