How to Install InvenioRDM on OpenBSD

InvenioRDM is an open-source research data management software developed by CERN. It enables users to store, manage, and share research datasets.

This tutorial will guide you through the process of installing InvenioRDM on OpenBSD using Docker. Docker allows you to run InvenioRDM in a container, which simplifies the setup process and ensures that the software is isolated from the host system.

Before we begin, ensure that you have Docker installed on your OpenBSD machine. You can install Docker by running the following command in your terminal:

$ doas pkg_add docker

Step 1: Install Docker Compose

Docker Compose is a tool for defining and running multi-container Docker applications. It allows you to define your application's services, networks, and volumes in a single YAML file, making it easy to deploy and manage complex applications.

To install Docker Compose on OpenBSD, run the following command in your terminal:

$ doas pkg_add py3-pip
$ doas pip3 install docker-compose

Step 2: Download the InvenioRDM Docker Compose File

The InvenioRDM project provides a Docker Compose file that you can use to deploy InvenioRDM. Download the Compose file by running the following command in your terminal:

$ curl -L https://raw.githubusercontent.com/inveniosoftware/docker-invenioRDM/master/docker-compose.yml > docker-compose.yml

Step 3: Modify the Compose File (Optional)

The Compose file provided by InvenioRDM is pre-configured with default settings. If you need to customize the settings, you can modify the Compose file to suit your needs.

For example, you can change the database settings if you have a pre-existing database that you want to use with InvenioRDM. To do this, open the docker-compose.yml file in a text editor and modify the DATABASE_URL environment variable to point to your database.

Step 4: Start the InvenioRDM Docker Container

To start the InvenioRDM Docker container, navigate to the directory that contains the docker-compose.yml file and run the following command:

$ doas docker-compose up -d

This will start the InvenioRDM container in detached mode. You can check the status of the container by running the following command:

$ doas docker ps

You should see the InvenioRDM container listed in the output.

Step 5: Access InvenioRDM

Once the InvenioRDM container is up and running, you can access the interface by opening your web browser and navigating to http://localhost:8000. You should see the InvenioRDM login page.

To log in to the system, use the default username and password:

• Username: admin@inveniosoftware.org
• Password: 12345678

After you log in, you can create new users, set up collections, and manage datasets.

Conclusion

InvenioRDM is a powerful research data management tool that can help you store, manage, and share research datasets. By following this tutorial, you should now have InvenioRDM up and running on your OpenBSD machine using Docker. Feel free to explore the functionality of the software and customize it to suit your needs.

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!