Samvera Hyrax is a robust digital repository solution built on top of the Fedora/Hydra stack. The installation process is not as difficult as it seems, and with this step-by-step guide, you will be up and running in no time.
Before you begin installing Samvera Hyrax, ensure that your system meets the following prerequisites:
Open a terminal window and update the system by running the following command:
sudo apt update && sudo apt upgrade
Next, install the necessary dependencies required for Samvera Hyrax installation. Run the following command:
sudo apt install imagemagick libmagickwand-dev npm nodejs postgresql-12 postgresql-server-dev-12
In this tutorial, we will be using Ruby version 2.7.4. To install Ruby on your system, enter the following commands in the terminal:
sudo apt-add-repository ppa:rael-gc/rvm
sudo apt update
sudo apt install rvm
rvm install 2.7.4
rvm use 2.7.4 --default
Once Ruby is installed, we need to install the Bundler tool, which is a dependency manager for Ruby. Run the following command in the terminal:
gem install bundler
To clone the Samvera Hyrax repository, run the following command in the terminal:
git clone https://github.com/samvera/hyrax.git
Navigate to the cloned repository directory and run the following command to install the Samvera Hyrax dependencies:
bundle install --without development test
Next, set up the database by running the following commands:
bin/rails db:migrate
bin/rails hyrax:default_collection_types:create
bin/rails hyrax:workflow:load
bin/rails hyrax:default_admin_set:create
Finally, start the server by running the following command:
bin/rails server
To access Samvera Hyrax, open your web browser and enter the following URL in the address bar:
http://localhost:3000/
You should now be able to see the Samvera Hyrax landing page.
Congratulations! You have successfully installed Samvera Hyrax on your Linux Mint system!
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
Alternatively, for the best virtual desktop, try Shells!
