Installing Samvera Hyrax on Elementary OS Latest

In this tutorial, we will walk through the steps to install Samvera Hyrax on your Elementary OS Latest computer. Samvera Hyrax is a digital repository software that enables organizations to create, manage, and publish digital content.

Prerequisites

Before installing Samvera Hyrax, you will need to ensure that your system meets the following prerequisites:

  • Elementary OS Latest installed on your computer
  • Ruby version 2.6.3 or higher installed
  • Rails version 6.0.3.4 installed
  • PostgreSQL database installed and running
  • Node.js installed

Step 1: Install Samvera Hyrax

To install Samvera Hyrax, open your terminal and execute the following commands:

# Clone the Samvera Hyrax repository
git clone https://github.com/samvera/hyrax.git

# CD into the hyrax directory
cd hyrax

# Install the required gems
bundle install

# Create the database
rake db:create

# Run the database migrations
rake db:migrate RAILS_ENV=development

# Start the server
rails server

After executing the above commands, you can access the Samvera Hyrax application by navigating to http://localhost:3000 in your web browser.

Step 2: Configure the application

By default, the Samvera Hyrax application is configured to use SQLite as the database. If you want to use a PostgreSQL database, you will need to update the config/database.yml file with your PostgreSQL credentials.

development:
  <<: *default
  database: myapp_development
  username: myapp
  password: <%= ENV.fetch("MYAPP_DATABASE_PASSWORD") { "password" } %>

Replace the above configuration with the following configuration:

development:
  adapter: postgresql
  encoding: unicode
  database: myapp_development
  pool: 5
  username: postgres
  password:
  host: localhost

Step 3: Create an admin user

To create an admin user for the Samvera Hyrax application, execute the following command:

rails hyrax:default_admin_set:create

This will create a default admin user with the following credentials:

After creating the admin user, you can log in to the Samvera Hyrax application and start managing digital content.

Conclusion

In this tutorial, we have walked through the steps to install and configure Samvera Hyrax on your Elementary OS Latest computer. With Samvera Hyrax, you can easily create, manage, and publish digital content through a web-based interface.