Samvera Hyrax is an open-source web application that helps institutions create and manage digital repositories. In this tutorial, we will guide you through the steps of installing Samvera Hyrax on macOS.
Homebrew is a popular package manager for macOS. You can install it by opening the Terminal app and running the following command:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
Use Homebrew to install the required dependencies:
brew install imagemagick sqlite node yarn
You can install Ruby using a version manager like rbenv or rvm. Here we will use rbenv:
brew install rbenv
After installing, add the following line to your shell profile (~/.bashrc, ~/.zshrc, or ~/.profile):
eval "$(rbenv init -)"
Then, install Ruby:
rbenv install 2.7.2
rbenv global 2.7.2
Bundler is a Ruby tool for managing dependencies of a project. Rails is a popular web application framework. To install Bundler and Rails, run the following commands:
gem install bundler
gem install rails
You can install Samvera Hyrax by cloning the GitHub repository:
git clone https://github.com/samvera/hyrax.git
cd hyrax
Next, use Bundler to install the required gems:
bundle install
Copy the example configuration files and modify them as needed:
cp config/database.yml.example config/database.yml
cp .env.example .env
Create the database and run the migrations:
rails db:create
rails db:migrate
Start the application server:
rails server
You can access the running application by pointing your web browser to http://localhost:3000.
Congratulations! You have successfully installed Samvera Hyrax on your macOS machine.
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!
