Helmholtz Research Software Directory

The Helmholtz Research Software Directory is a place to discover and promote research software. Designed for Research Software Engineers and Scientists, it aims to foster FAIR and reuseability of software.


Cite this software

What Helmholtz Research Software Directory can do for you



DOI Research Software Directory GitHub license fair-software.eu CII Best Practices Contributor Covenant Frontend tests Backend tests Scraper tests E2E tests Ubuntu E2E tests Firefox E2E tests Chrome E2E tests MacOS

:exclamation: HIFIS Notes :exclamation:


Welcome to the HIFIS-Fork of the Research Software Directory. This fork contains adjustments for the Helmholtz version of the RSD.

::: End of HIFIS notes

Our mission: To promote the visibility, impact and reuse of research software

This repo contains the new RSD-as-a-service implementation. The service can be found at: https://research-software-directory.org

How to build and run the RSD

Building from source code

  1. Before installing the dependencies ensure that you have docker and docker compose V2 (see the documentation of Docker Compose) locally.
  2. You will also need make and yarn to automate the configuration and installation process.
  3. Set the required environment variables: Copy the file .env.example to .env file at the root of the project and fill the secrets and passwords. Check if the secrets are correct. The Makefile will take care about creating an appropriate frontend/.env.local from the .env file.
  4. Run make install to install all dependencies and build the docker images.

Running the services

# Start the containers via the make file
make start
# OR directly use docker compose
docker compose up

Stopping the services

# Stop all services via the makefile
make stop
# OR directly use docker compose
docker compose down

Developing the frontend

You can run frontend in development mode as docker a service (called frontend-dev) that enables hot reloading. By default this frontend-dev service will not be started automatically. For more detailed instructions see frontend/README.md.

# Run frontend development using docker at http://localhost:3000
make frontend-docker
# OR use docker compose directly
docker compose up --scale frontend=0 --scale scrapers=0 --scale frontend-dev=1

It is possible to directly run the frontend too (without using a docker container). You must then have NodeJS installed, preferably v18.

# Build and install all dependencies.
make install
# Run the frontend and the documentation on localhost:3000 and localhost:3030
make dev
# Stop all services with `docker compose down`
make down

More information about building and data migration can be found in Getting started documentation.


The content of this repository is licensed under several licenses. We follow the REUSE specification to indicate which license applies to the files specifically. Here are some general hints:

  • Helmholtz specific source code is licensed under EUPL-1.2
  • Source code coming from upstream is licensed under Apache-2.0
  • Documentation and most images are licensed under CC BY-4.0
  • Some files with trivial content, e.g. configuration files, are licensed under CC0-1.0

For more details on the licenses, please have a look at the file headers or associated *.license files. The terms of all used licenses are located in the LICENSES directory.

Logo of Helmholtz Research Software Directory
Programming languages
  • TSX 62%
  • TypeScript 19%
  • Java 9%
  • PLpgSQL 7%
  • JavaScript 2%
  • EUPL-1.2
</>Source code

Participating organisations

Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences
Helmholtz-Zentrum Dresden-Rossendorf
Helmholtz Centre for Environmental Research (UFZ)
Netherlands eScience Center


The Research Software Directory in Helmholtz

Author(s): Christian Meeßen, Uwe Konrad, Martin Hammitzsch
Published in 2022


Project manager
Helmholtz Centre Potsdam - GFZ German Research Centre for Geosciences
Felix Mühlbauer
Helmholtz Centre Potsdam - GFZ German Research Centre for Geosciences
Marc Hanisch
Helmholtz Centre Potsdam - GFZ German Research Centre for Geosciences
Matthias Rüster
Helmholtz Centre Potsdam - GFZ German Research Centre for Geosciences
Norman Ziegner
Helmholtz Centre for Environmental Research GmbH - UFZ
Sven Reißland
Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences Potsdam

Related projects


Helmholtz Federated IT Services

Updated 1 month ago