Skip to content

Downloads

Achilleas Koutsou edited this page Aug 9, 2017 · 16 revisions

The GIN command line client is available for Windows, macOS, and Linux.

Latest version downloads:

Looking for older versions? Complete list of downloads.

NOTE: Older versions are kept for archival purposes and are not supported. Incompatibilities between server and client changes could lead to unpredictable behaviour.

Which do I need?

The GIN service is essentially a git server which also works as a git annex remote. The GIN command line client works partially as a wrapper for git and git annex commands. Therefore, it depends on git and git annex. For operating systems and distributions which don't provide straightforward installation of git annex, we provide bundled packages to make installation straightforward.

See the corresponding section for each OS for details.

Windows

For Windows, we provide a bundled package that includes everything required to run the client.

To use it:

  • Download the zip file
  • Extract it anywhere on your hard drive (e.g., C:\gin)
  • Navigate to the gin directory and double click gin-shell.bat

This will present you with a command prompt that is ready to use the client. Type gin --help and gin cmdhelp to see the available commands and their description.

Download links

macOS

On macOS, git annex is available for download from the git annex website. Alternatively, it can be installed using Homebrew using brew install git-annex.

Once you've installed git annex, simply download the gin client for macOS, extract the archive, and put the file named gin in a location that's included in your $PATH.

An installable package will be available soon.

Type gin --help and gin cmdhelp to see the available commands and their description.

Download links

Linux

If your distribution's repositories provide git annex, you may download the gin client for Linux, extract the archive, and put the file named gin in a location that's included in your $PATH.

If your distribution does not provide git annex, you can download and install it manually.

For Debian based distributions, we provide a bundled deb file which includes git annex and can be installed and used directly.

An RPM package will be available soon.

Type gin --help and gin cmdhelp to see the available commands and their description.

Download links

Compiling from source

The GIN client is written in Go. It requires Go 1.8 or above installed.

To build gin-cli and all its dependencies, simply run

go get -v github.com/G-Node/gin-cli

Once the get completes, you should find the gin-cli (or gin-cli.exe) executable inside $GOPATH/bin/ ($HOME/go/bin/ on Unix and %USERPROFILE%/go/bin/ on Windows). Note that pre-built packages rename the executable to gin, so documentation, help text, and tutorials use gin instead of gin-cli.

Clone this wiki locally