Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This project builds an open-source cross-platform native client for iRODS ( with a graphical user interface. The software is implemented in C++ and builds currently against irods-4.1.x on Linux and Mac OS X 10.10. Binary distributions are provided for CentOS/RHEL 6 and 7 and for Mac OS X 10.10 and 10.11.


In CentOS/RHEL Linux distributions the installation of the binary packages is very straightforward.

yum -y install epel-release
yum -y install
yum -y install
yum -y install

In OS X you need to download the OS X .pkg file from and right-click the download to open contextual menu from which selecting open will prompt you for confirmation to install an unsigned package (as I don't have an Apple Developer ID yet).

Getting started

For now, irodsclient uses the same configuration as irods-icommands. In the future the client will have its own configuration and credentials management with the option to revert to iRODS environment.

So to be able to connect, you should have the iRODS environment configured at


and then run

irodsclient &

In OS X after the package install process is finished you have the irodsclient and a full distribution of irods-icommands at /Applications/ To configure the iRODS environment you need to update your shell configuration as follows (for bash, zsh etc. Bourne-derived shells)

export PATH=/Applications/$PATH

In your iRODS environment file at ~/.irods/irods_environment.json you need to define

"irods_plugins_home": "/Applications/"

That concludes the install procedure, running iinit will initialize your iRODS commandline and GUI environment.

Building from source

The following instructions should work on CentOS/RHEL 6 and 7 and probably on Fedora as well.

yum -y groupinstall "Development Tools"
yum -y install epel-release
yum -y install openssl-devel libcurl-devel qt5-qtsvg-devel qt5-qtbase-devel

# for example for CentOS/RHEL 6
yum -y install
yum -y install
yum -y install

On Ubuntu 14.04 and up you can install build depedencies with (thanks to Paul van Schayck for this information!)

# for Ubuntu 14.04 LTS and upwards
sudo apt-get install qt5-qmake qtbase5-dev libqt5svg5-dev libcurl4-nss-dev qt5-default

Building the application is done simply via

git clone
cd kanki-irodsclient
./ [ -q /usr/lib/x86_64-linux-gnu/qt5 for Ubuntu! ]

You can install the binary and config into place by running

sudo install ./src/irodsclient /usr/bin
sudo install -D -m 644 ./src/schema.xml /etc/irods/schema.xml