Before getting hands on OpenShift , we need to setup our machine with client tools, lets see how :

Installing client tools on RHEL :

Below are the pre-requisites :

* Red Hat Enterprise Linux 6 or later

* Sudoer or root access (Shouldn’t be a problem if you own a machine or will write an article about how to crack root ;))

* Ruby version 1.8.7 or later installed

$ yum install ruby

* RubyGems installed (including rubygem-json and rubygem-parseconfig)

$ yum install rubygem-json
$ yum install rubygem-parseconfig

1. You must have rot privilages for below :

Create “openshift.repo” file inside “/etc/yum.repos.d”

[root@nikhil ~]# touch openshift.repo
[root@nikhil ~]# vi openshift.repo

copy below content and save the file :


2. Download the latest Extra Packages for Enterprise Linux (EPEL) RPM package to your preferred directory from one of the mirrors located at

Be sure to select the correct package for your system architecture. For example, the latest package for a 64-bit x86 system architecture at the time of this writing is epel-release-6-5.noarch.rpm.

You can get it from

3. Now install the downloaded package as :

$ sudo yum localinstall epel-release-6-5.noarch.rpm

The epel.repo file will be created in the /etc/yum.repos.d directory.

4. Run the following command to install the OpenShift client tools:

$ sudo yum install rhc
Dependencies Resolved
Install      10 Packages
Upgrade       1 Package

Total size: 6.6 M
Total download size: 4.8 M
Is this ok [y/N]: y
Importing GPG key 0x897DA07A:
Userid: "Red Hat, Inc. (Beta Test Software) "
From  :
Is this ok [y/N]: y

Note : If by any chance your terminal/system hungs, close the window. Open a fresh window and run below :

$. /etc/bash_completion.d/rhc

This will take care of remaining installation.

You need to install the client tools according to your OS. Below links can be referred for different OS :

Fedora :


Windows :

Ububtu and SUSE :

If you enjoyed this post, please consider leaving a comment or subscribing to the RSS feed to have future articles delivered to your feed reader.