How to Install Samvera Hyrax on nixOS Latest

Samvera Hyrax is an open-source digital repository solution that is specifically designed for digital materials. In this tutorial, we will walk you through the steps to install Samvera Hyrax on nixOS Latest.

Prerequisites

Before we get started with the installation, here are the prerequisites that you need:

  1. A nixOS Latest system with sudo privileges.
  2. A working internet connection.

Step 1: Install Dependencies

The first step is to install the dependencies that Samvera Hyrax requires. To do this, open the terminal and run the following command:

sudo nix-env -iA nixpkgs.gnu-tar curl

This will install the necessary dependencies.

Step 2: Install the Required Packages

Next, you need to install the required packages for Samvera Hyrax. Run the following command in the terminal:

sudo nix-env -f https://github.com/samvera/hyrax/archive/v4.0.0.tar.gz -iA hyrax

This command will download and install the Samvera Hyrax package.

Step 3: Setup the Database

Now that the packages are installed, you need to set up the database. Samvera Hyrax uses PostgreSQL as the database management system. Run the following command in the terminal:

sudo nix-env -i postgresql pgadmin

This will install PostgreSQL and pgAdmin which is a graphical tool for managing databases.

After installing, initialize the database by executing the following commands:

sudo systemctl start postgresql
sudo su postgres -c 'createdb hyrax_development;'

You can check if the database is running by typing the following command:

sudo systemctl status postgresql

Step 4: Configure the Application

Navigate to the directory where you’d like to set up the application and run the following command:

sudo hyrax new demo

This command configures the application with the name demo. Change the directory to the newly created demo directory:

cd demo

Now, open the config/database.yml file and edit the following line with your PostgreSQL username and password:

username: postgres
password: password

Save the changes to the file.

Step 5: Start the Application

Start the application by running the following command:

sudo rails server

This command will start the server for the Samvera Hyrax application.

Conclusion

In conclusion, these are the steps to install Samvera Hyrax on nixOS Latest. Once the installation process is complete, you can start exploring and using Samvera Hyrax to manage your digital materials. Happy coding!