How to Install Samvera Hyrax on Kali Linux

Samvera Hyrax is an open-source digital repository application that provides access and preservation of digital content. In this tutorial, we will guide you through the steps to install it on Kali Linux.

Prerequisites

Before we begin with the installation, make sure you have the following prerequisites:

  • Kali Linux Latest (64-bit)
  • Ruby 2.7.4 or higher
  • MySQL 5.7 or higher
  • Node.js 12.x or higher
  • Yarn 1.22.x or higher

Step 1: Install Dependencies

Start by updating and upgrading your system packages using the following command:

sudo apt-get update && sudo apt-get upgrade

Next, install the necessary dependencies using the command below:

sudo apt-get install build-essential openssl libreadline6 libreadline6-dev \
curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-dev \
sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev libncurses5-dev \
automake libtool bison subversion pkg-config

After installing the dependencies, proceed to install RVM.

Step 2: Install RVM

RVM is a Ruby version manager that makes it easy to install and manage different Ruby versions.

To install RVM, use the command below:

gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 \
&& curl -sSL https://get.rvm.io | bash -s stable

After installing RVM, restart your terminal and install Ruby 2.7.4 using the command:

rvm install 2.7.4

After installing Ruby, set it as your default version using:

rvm use 2.7.4 --default

Step 3: Install MySQL

MySQL is used as the database for the Hyrax application. Install MySQL using the command:

sudo apt-get install mysql-server

After installation, start and enable the service using:

sudo systemctl start mysql
sudo systemctl enable mysql

Step 4: Install Node.js and Yarn

Hyrax uses Node.js and Yarn as its front-end dependencies. Install them using the command:

curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo npm install -g yarn

Step 5: Install Hyrax

We are ready to install Hyrax now. Clone the Hyrax repository on GitHub using the command:

git clone https://github.com/samvera/hyrax.git

Once the cloning process is complete, navigate to the hyrax directory using:

cd hyrax

Install the bundle using the command:

bundle install

Create the database and run the database migrations using:

bundle exec rails db:create
bundle exec rails db:migrate

Start the server using the command:

bundle exec rails server

Access the Hyrax application by opening a web browser and visiting http://localhost:3000. You should now see the Hyrax welcome page.

Conclusion

You have successfully installed Samvera Hyrax on your Kali Linux environment. You can now start customizing and exploring this powerful digital repository application.