iRODS Manual (4.0.3), Aug 2014 (PDF, 539KB)

Release notes for recent iRODS releases are available on GitHub.

(Notes for iRODS 3.3.1 and earlier are available on the legacy wiki.)

Source Code

iRODS source code is available on GitHub at

Binary Distributions

Binaries are provided to install iRODS for specific combinations of architecture and operating system. Find your combination below and click to download. Please note:

  • Deploying an iCAT server requires the iCAT package and one database plugin package.
  • Additional resource servers may be deployed using the resource server package.
  • To deploy iCommands on a client machine, use the iCommands package.
iCAT Server
irods-icat-4.0.3-64bit   [deb] [CentOS5 rpm*] [CentOS6 rpm*] [SUSE rpm*]

*Please see this rpm installation how-to before installing.

Database Plugins
irods-database-plugin-postgres-1.4   [deb] [CentOS5 rpm (1.3)] [CentOS6 rpm] [CentOS6 (w/ PostgreSQL93) rpm] [SUSE rpm (1.3)]

irods-database-plugin-mysql-1.4   [deb] [CentOS6 rpm] [SUSE rpm (1.3)]
Note: lib_mysqludf_preg functions are required for MySQL. See the iRODS manual for details.

irods-database-plugin-oracle-1.4   [deb] [CentOS5 rpm (1.3)] [CentOS6 rpm]

Resource Server
irods-resource-4.0.3-64bit   [deb] [CentOS5 rpm] [CentOS6 rpm] [SUSE rpm]
iCommands CLI

This package installs just the client iCommands. Install this package if you want to have a system-wide installation of the iCommands (in /usr/bin), but do not want the entire server. The iCommands are already included in both the iCAT and Resource packages – so installing this package in addition is unnecessary (and will conflict).

irods-icommands-4.0.3-64bit   [deb] [CentOS5 rpm] [CentOS6 rpm] [SUSE rpm]

Development Tools

This package installs all the relevant header files necessary for development of iRODS plugins (microservices, resources, etc.). The development package requires the runtime package.

irods-dev-4.0.3-64bit   [deb] [CentOS5 rpm] [CentOS6 rpm] [SUSE rpm]

Runtime Libraries

This package installs precompiled shared object (.so) files. The runtime package is a dependency of the development package.

irods-runtime-4.0.3-64bit   [deb] [CentOS5 rpm] [CentOS6 rpm] [SUSE rpm]

Zone Report

This set of two plugins (api and icommands) can be used to provide a nearly comprehensive snapshot of the configuration of an iRODS Zone. When run by an authenticated rodsadmin account, the izonereport icommand will generate JSON. This JSON can be validated against the iRODS zone_bundle.json schema

irods-api-plugin-zonereport-1.0   [deb] [CentOS5 rpm] [CentOS6 rpm] [SUSE rpm]

irods-icommands-zonereport-1.0   [deb] [CentOS5 rpm] [CentOS6 rpm] [SUSE rpm]

Authentication Plugins

irods-auth-plugin-gsi-1.1   [deb] [CentOS5 rpm] [CentOS6 rpm]

irods-auth-plugin-krb-1.1   [deb] [CentOS5 rpm] [CentOS6 rpm] [SUSE rpm]

Resource Plugins

irods-resource-plugin-s3-1.2   [source and usage] [deb] [CentOS5 rpm] [CentOS6 rpm] [SUSE rpm]

irods-resource-plugin-wos-1.1   [source and usage] [deb] [CentOS5 rpm] [CentOS6 rpm] [SUSE rpm]

irods-resource-plugin-hpss-1.0   [source and usage] [CentOS6 rpm]

Microservice Plugins

irods-microservice-plugins-curl-1.1   [deb] [CentOS5 rpm] [CentOS6 rpm] [SUSE rpm]

A full listing for iRODS 4.0.3 is available here:


Please confirm any checksum values before installing: checksums.txt

Installation Examples

From .deb package:
sudo dpkg -i irods-icat-4.0.3-64bit.deb irods-database-plugin-postgres-1.3.deb
sudo apt-get -f install

From .rpm package:
Read and follow the RPM_INSTALLATION_HOWTO.txt instructions before installing an RPM.
sudo rpm -i irods-icat-4.0.3-64bit-centos6.rpm irods-database-plugin-postgres-1.3-centos6.rpm

Upgrade Examples

From .deb package:
sudo dpkg -i irods-icat-4.0.3-64bit.deb

From .rpm package:
sudo rpm -U irods-icat-4.0.3-64bit-centos6.rpm