How to install Samvera Hyrax on Windows 10

Samvera Hyrax is an open-source digital repository platform designed for institutions to manage and publish digital assets. In this tutorial, we will demonstrate how to install Samvera Hyrax on Windows 10.

Prerequisites

Before we begin, make sure you have the following requirements:

  • Ruby version 2.6
  • Rails version 5.2.4.1
  • Git version control system
  • Node.js and Yarn

Step 1: Install Ruby

To install Ruby, follow these steps:

  1. Download the Ruby 2.6.6 installer from the Ruby website: https://rubyinstaller.org/downloads/

  2. Select the appropriate platform for your system architecture and follow the installation instructions.

  3. During the installation process, make sure to select the option to install the Development Kit.

Step 2: Install Rails

To install Rails, follow these steps:

  1. Open a command prompt and type the following command:
gem install rails -v 5.2.4.1
  1. Wait for the installation to complete.

Step 3: Install Git

To install Git, follow these steps:

  1. Download the Git installer from the Git website: https://git-scm.com/downloads

  2. Select the appropriate platform for your system architecture and follow the installation instructions.

Step 4: Install Node.js and Yarn

To install Node.js and Yarn, follow these steps:

  1. Download the Node.js installer from the Node.js website: https://nodejs.org/en/download/

  2. Select the appropriate platform for your system architecture and follow the installation instructions.

  3. Download the Yarn installer from the Yarn website: https://classic.yarnpkg.com/en/docs/install/

  4. Select the appropriate platform for your system architecture and follow the installation instructions.

Step 5: Clone the Samvera Hyrax repository

To clone the Samvera Hyrax repository, follow these steps:

  1. Open a command prompt and navigate to the directory where you want to install Samvera Hyrax.

  2. Clone the repository by running the following command:

git clone https://github.com/samvera/hyrax.git
  1. Wait for the cloning to complete.

Step 6: Install dependencies

To install the dependencies for Samvera Hyrax, follow these steps:

  1. Navigate to the directory where Samvera Hyrax is installed.

  2. Run the following command to install the dependencies:

bundle install

  1. Wait for the installation to complete.

  2. Run the following command to install JavaScript dependencies:

yarn install
  1. Wait for the installation to complete.

Step 7: Initialize the database

To initialize the database for Samvera Hyrax, follow these steps:

  1. Navigate to the directory where Samvera Hyrax is installed.

  2. Run the following commands to create the database:

rake db:create
rake db:migrate
  1. Wait for the commands to complete.

Step 8: Start the server

To start the server for Samvera Hyrax, follow these steps:

  1. Navigate to the directory where Samvera Hyrax is installed.

  2. Run the following command to start the server:

rails server

  1. Wait for the server to start.

  2. Open your web browser and navigate to http://localhost:3000/

  3. You should now be able to access the Samvera Hyrax application.

Congratulations! You have successfully installed Samvera Hyrax on Windows 10.