DNS automation with Chef

Configure your DNS with our cookbook

Open source

Contribute and help improve the cookbook.

Available at the Supermarket

Get up and running quickly.

Illustration of a ruler and a piece of cheese

Quality metrics

We're part of the Partner Cookbook Program.

Get the cookbook from the Chef Supermarket

How to use it

A resource supporting automatic DNS configuration via DNSimple's API.

Create records

dnsimple_record 'Create an A record' do
  name          'test'
  content       '16.8.4.2'
  type          'A'
  domain        'example.com'
  access_token  chef_vault_item('secrets', 'dnsimple_token')
  action        :create
end

Update records

dnsimple_record 'Update an A record' do
  name          'test'
  content       node['ipaddress']
  type          'A'
  domain        'example.com'
  access_token  chef_vault_item('secrets', 'dnsimple_token')
  action        :update
end

Remove records

dnsimple_record 'Delete www record' do
  name          'www'
  type          'CNAME'
  domain        'example.com'
  access_token  chef_vault_item('secrets', 'dnsimple_token')
  action        :destroy
end

Checkout the cookbook docs

Powered with DNSimple's API

Robust and well documented.

Our API is the secret ingredient that makes this cookbook unique. It's easy to mix in and customize to your needs.

Read the API v2 docs

We're stoked to be part of the Chef Partner Cookbook Program