What is GIN?

Management of scientific data, including consistent organization, annotation, and storage of data, is a challenging task. Accessing and managing data from multiple workplaces while keeping it in sync, backed up, and easily accessible from within or outside the lab is even more demanding. To minimize the time and effort scientists have to spend on these tasks, we developed the GIN (G-Node Infrastructure) services, a free data management system designed for comprehensive and reproducible management of scientific data.

Schematic overview of GIN illustrating its many usage possibilities.

GIN offers many features (see to the right). It is a web-based repository store that you can reach from everywhere, which is secure and which provides fine-grained access control to share your data. This enables sharing data with collaborators or publishing your data to the greater scientific community. Both you and your collaborators can work independently, using versioned repositories at work, at home, or wherever you want. All this can either be achieved with our GIN client or by using the underlying tools (git, git-annex) directly. You can also set up your own GIN server.

If you are unfamiliar with GIN and/or its git foundation, you can find more details in our short GIN introduction.

Why you should use GIN

In short: GIN gives you a lot of possibilities while minimizing the time and effort you need to invest. It allows you to:

Manage your research data

  • Upload and access your data anywhere, anytime: Because your data is stored within repositories, any changes you make whether locally or online can be easily tracked and thereby you can keep your data in sync.

Version your data

  • When changing your files and uploading them to the server, the history is automatically kept, you can always go back to a previous version.

Share your data

  • Collaborating with others in GIN is incredibly easy: you can assign specific read-only / read-write permissions for particular users, make your data publicly available or even citable with GIN's own DOI service.

Open Source

  • On top of all these advantages, using GIN is flexible, free and open source! You can use it locally, online or even set up your own in-house instance.

Obtaining a DOI

A DOI registration can be obtained after a couple of easy steps: uploading the data, making the repository public, creating a DOI request file, structuring it and finally requesting the DOI. See details here.

How do I start?

Quickstart: Web interface

  1. Register an account on the GIN server.
  2. Create a repository and initialize it with a README.
  3. Upload some data to this repository using the web interface (max 3GB per file & 10 files per upload).
  4. Browse your files. Continue with Obtaining a DOI, sharing your data or simply with adding more files.
  5. Read the detailed How to for further instructions.

Quickstart: Local GIN client

  1. Register an account on the GIN server.
  2. Download and install the GIN Client (see here for a guide).
  3. Confirm that everything is working properly by typing the command gin --version.
  4. Use gin login to confirm your identity with the GIN server (This requires the username and password from your GIN server account).
  5. Use gin create <repository name> to initialize a new repository, gin get <user name>/<repository name> to download an already initialized repository to your local workspace.
  6. Add files to your local repository and upload them to your GIN server repository using gin upload .
  7. Browse your files locally or online. Continue with Obtaining a DOI, sharing your data or simply with adding more files.

Detailed Walkthroughs

You can use the GIN system in two ways: via our website or via a downloadable GIN client. For detailed walkthroughs on setup/installation, basic and advanced workflows, as well as tips and tricks, check out the corresponding links below.

Here are also some notes on how to use git-annex directly.

Advanced: Setting up your own in-house GIN service

All of the GIN services are Open Source software. If you want to manage your data solely within your lab on your own servers, this can easily be done! Find instructions here.

FAQ, Troubleshooting, and further questions

If you run into any problems during the setup or usage of the GIN services, we would invite you to first check out our FAQ. If nothing there was able to solve your problem, then we would be happy to help you out in person! You can contact us via email (gin@g-node.org) or on gitter.

For anything bug related regarding ...

Kateryna Nosenko edited this page 7 months ago