Build Status

API Version

This library currently uses the DNSimple API v2 and it is compatible with the legacy implementation bundled with the fog gem.


Add this line to your application's Gemfile:

gem 'fog-dnsimple'

And then execute:


Or install it yourself as:

gem install fog-dnsimple


Initialize a Fog::DNS object using the DNSimple provider.

dns ={
  provider:         "DNSimple",
  dnsimple_token:   "YOUR_API_TOKEN",
  dnsimple_account: "YOUR_ACCOUNT_ID",
  • YOUR_API_TOKEN: This is the API v2 access token. You can create it from your account page: Account > Access Tokens > Account access tokens.
  • YOUR_ACCOUNT_ID: This is the account ID. We currently support only the numeric ID (account string identifiers will be supported in the future). The account ID is the numeric ID after the /a in the path prefix. For instance, if the account page is, the account ID is 1234.

This can then be used like other Fog DNS providers.

zone = dns.zones.create(
  domain: ""
record = zone.records.create(
  name: "foo",
  value: "",
  type: "A"

The following configurations are supported:

dns ={
  # Use dnsimple_url to provide a different base URL, e.g. the Sandbox URL
  dnsimple_url:   "",


  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 new Pull Request