• 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', '~> 4.0'

To use the WHOIS parser component you need to install the whois-parser gem:

$ gem install whois-parser
gem 'whois-parser'

The whois-parser gem already depends on the whois gem. If you install whois-parser, whois will be installed as well and it will also be automatically required when you require 'whois-parser'.


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 4.0 upgrade file explains how to upgrade from Whois 3 to Whois 4.

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

This library is versioned using the rules of Semantic Versioning.