Setup your own#

Running the application#

To quickly get something running download the (latest) version of the application from http://download.systemsbiology.nl/unlock/ and download the fairds-latest.jar file.

To start the program in a terminal (Linux/Mac) or Command Prompt/Powershell in Windows by typing: java -jar fairds-latest.jar

When you see the following line, the application has started…

Started Application in 3.666 seconds (process running for 6.147)

Now you can access the application using your browser at http://localhost:8083

(The application is now only accessible from your own device)

Here you can generate your templates and validate your metadata. Or you can work on your own metadata packages, see: Templates

Using docker#

When you want to use the application through docker the following command can be used:

Mac:

docker run -v $PWD/fairds_storage:/fairds_storage -it -p 8083:8083 docker-registry.wur.nl/m-unlock/docker/fairds:latest

Linux:

docker run -v $PWD/fairds_storage:/fairds_storage -it -p 8083:8083 docker-registry.wur.nl/m-unlock/docker/fairds:latest

Windows:

docker run -v “%cd%”/fairds_storage:/fairds_storage -it -p 8083:8083 docker-registry.wur.nl/m-unlock/docker/fairds:latest

This command will mount the current directory into the fairds_storage folder inside the docker to ensure that all files are stored locally.

Configuring the application#

After the inital startup of the application a fairds_storage folder will be created in the current directory. This folder contains the configuration file for the application, the metadata file to ensure term standardisation and additional folders for various modules (if enabled).

fairds_storage
fairds_storage/bioprojects
fairds_storage/bioprojects/raw
fairds_storage/config.yaml
fairds_storage/metadata.xlsx
fairds_storage/validation

The config.yaml file contains the configuration for the application. You can edit this file to change the settings of the application. The following settings can be changed:

# Menus enabled in the FAIR Data Station
menus:
  about: true
  configurator: true
  validator: true
  bioprojects: true
  ena: true
  terms: true
  irods: true
  api: true

The first section of the configuration file contains the menus that are enabled in the FAIR Data Station. You can enable or disable the menus by setting the value to true or false.

counter:
  goat: '<script data-goatcounter="https://fairds.goatcounter.com/count" async src="//gc.zgo.at/count.js"></script>'

The counter section contains the code for the GoatCounter, which is used to track the usage of the FAIR Data Station. You can remove this section if you do not want to use GoatCounter or you can change it for your own instnace.

params:
  irods_investigation_directory: /{ZONE}/home/

The irods_investigation_directory parameter defines the root path for new investigations in iRODS, where {ZONE} is a placeholder that automatically resolves to the user’s zone after login, allowing zone-specific directory creation under (in this case) /home/.

irods_storage:
  tags:
    request for archive:
      attribute: "archive_status"
      value: "archive_requested"

This part of the YAML defines configurable archive request tags for iRODS. Each tag corresponds to a button in the iRODS archiving UI. When clicked, the button sets iRODS metadata using the specified attribute, value, and optionally units. In this example, the “request for archive” button will set archive_status = archive_requested on the selected data.

view:
  validation:
    investigation_identifier: "e.g. NWO_UNLOCK"
    investigation_title: "e.g. Synergies between biological and ozonisation processes for micropollutant removal"
    investigation_description: "e.g. investigation into optimizing micropollutant removal from wastewater treatment plant effluent using biological treatment and ozonation"
    study_identifier: "e.g. BO3B-BR1"
    study_title: "e.g. Optimizing conditions using bioreactors."
    study_description: "e.g. What type of bioreactors are best at removing organic matter from wastewater treatment plant effluent. And what conditions can optimize these processes."

The view section contains the example values for the investigation and study identifiers, titles, and descriptions. These values are used in the validation module to show to users what is expected in these fields. You can change these values to your own examples.

irods:
  - label: UNLOCK
    host: data.m-unlock.nl
    port: 1247
    zone: unlock
    authscheme: PAM
    ssl: CS_NEG_REQUIRE

  - label: Vrije Universiteit Amsterdam
    host: data.yoda.vu.nl
    port: 1247
    zone: vu
    authscheme: PAM
    ssl: CS_NEG_REQUIRE
...

The irods section contains the iRODS servers that are configured for the FAIR Data Station. You can add or remove iRODS servers by adding or removing the entries in this section. Each entry contains the label, host, port, zone, authscheme, and ssl settings for the iRODS server.