This page will lead you in the installation of the different tools needed to synchronise your gin tonic repository on your MAC or linux computer.

Step 1: Install Datalad (macOS)

For linux, please refer to the DataLad handbook for Linux computers: http://handbook.datalad.org/en/latest/intro/installation.html

A. Install homebrew (if not installed already)

The easiest way to install applications on OSX is to use homebrew (https://brew.sh/). If you prefer another route, please refer to the datalad handbook.

Open the terminal application and paste the following codes, type return, and wait:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

This can take some time, depending on your internet connection. You may now read the next step or go for a different task and come back in 20-30 minutes.

B. install DataLad

brew install git
brew install datalad

pip3 install datalad

You see we installed both the datalad commands, and the datalad python versions. Both are needed.

(While a version of Git is installed with datalad, it may not be directly found by the system, so it is easier to get a fresh install of Git via homebrew).

Step 2: Provide SSH keys

A. Create a key To create a ssh key, you may follow this tutorial. However, using Rstudio is much easier and faster.

Install R and RStudio via the installer, or via homebrew (see below). Note that the homebrew version of R is sufficient to get a SSH key, but would not work for coding in R.

Following Rstudio tutorial: in the tools menu, choose the global Options, choose Git/SVN, push the create SSH key button. Do NOT add a passphrase (simply leave it blank) ! Once the key is created, you View the public key and copy it.

B. Use the key

In GIN (in the internet browser), you need to add one key: click on your avatar on the top right corner of this page, choode your settings. Choose the SSH Keys vertical tab, then click the blue add Key button. Give it a name of your choice, and paste the public key text in the Contentsection.

Step 3: clone the GIN repository

Run datalad clone <ssh address>:

• Go to your .mainrepository and paste the ssh address you get. Its form should be similar to ssh://git@gindata.biologie.hu-berlin.de:10022/organame/projectname.main.git
• open a command terminal window, you may try to right click on a folder to open the terminal inside that specified folder
• write datalad clone
• paste the ssh address you copied before
• type return

The repository should be cloned at that point. This means that the content of the main repository will be downloaded on your local machine.

Step 4: Run the script for the first time

A. make it executable

Navigate to the research repository folder on your computer using the cd command, this will look like cd yourreponame.main. Then run:

chmod +x sync_unix

B. double click script

On your normal desktop window, the sync_unix file is now special, you can double click it and it will start the script. The script will initiate submodules.

Step 5-infinty

Make changes locally or with the browser and double click the same sync_unix script to synchronise the two copies.

The script will show you the changes made and ask you for a message that will be used to write the version history: describe the change made in that message. If there are no local changes, press return to download changes made online.

The script will then ask if he should drop content: this would delete the big files on your computer (only if the file is present on the server).

If necessary and update content from the server to your computer and vice versa.