Build Status

Esgob Ruby Client

Esgob Ltd operate an international network of anycast servers. Their Secondary DNS service is available for free. This Ruby Gem provides convenient access to the Esgob API.


Add this line to your application's Gemfile:

gem 'esgob'

And then execute:

$ bundle

Or install it yourself as:

$ gem install esgob


First create a new client instance, by passing in your account name and API key:

esgob ='account', 'key')

Alternatively, as it is often desirable to keep secrets outside of the source code, it is also possible to pass in the account name and API key using environment variables set in the shell:

export ESGOB_ACCOUNT=accountname
export ESGOB_API_KEY=4472ed80e0f511e4aee13c0754043581

The client instance can then be initialised without passing any arguments:

esgob =

Add a new slave domain, passing in the domain and the master DNS server to fetch the zone from:

esgob.domains_slaves_add('', '')

Get a list of the registered slave domains:

domains = esgob.domains_slaves_list

Here is an example of what can be done in an IRB session:

$ irb -resgob
irb(main):001:0> esgob =
=> #<Esgob::Client:0x007fd2e3b13420>
irb(main):002:0> esgob.domains_slaves_list
=> {""=>"", ""=>""}
irb(main):003:0> esgob.domains_slaves_list.keys
=> ["", ""]

See the API documentation for full details.

More information


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request


The esgob ruby gem is licensed under the terms of the MIT license. See the file LICENSE for details.