• Ruby >= 2.0.0

For older versions of Ruby, see the file.

Whois has been successfully tested against the following Ruby implementations:

Whois is a OS-independent library and doesn't require any external binaries or C libraries: it is a 100% Ruby software.

Installing Whois


You can install the gem manually:

$ gem install whois

Or use Bundler and define it as a dependency in your Gemfile:

gem 'whois', '~> 3.0'


The Whois repository is hosted on GitHub. You can start by watching or cloning the repository.

$ git clone git://
$ cd whois

Use Bundler to install the development dependencies.

$ bundle

Now run the tests to make sure everything is working as expected.

$ rake test

Upgrading Whois from a previous version

Install the newer version via RubyGems:

$ gem install whois

The CHANGELOG file contains a detailed list of all the changes, grouped by version.

This library is versioned using the rules of Semantic Versioning.