Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 501fa82e09

Fetching latest commit…

Cannot retrieve the latest commit at this time


Installs and configures Dan Bernstein's DNS tinydns, aka djbdns. Services are configured to start up under runit.



Known to work on Debian, Ubuntu, Red Hat and CentOS.


  • build-essential - for compiling the source.
  • runit - for setting up the services.


  • node[:djbdns][:tinydns_ipaddress] - listen address for public facing tinydns server
  • node[:djbdns][:tinydns_internal_ipaddress] - listen address for internal tinydns server
  • node[:djbdns][:public_dnscache_ipaddress] - listen address for public DNS cache
  • node[:djbdns][:axfrdns_ipaddress] - listen address for axfrdns
  • node[:djbdns][:public_dnscache_allowed_networks] - subnets that are allowed to talk to the dnscache.
  • node[:djbdns][:tinydns_internal_resolved_domain] - default domain this tinydns serves
  • node[:djbdns][:bin_dir] - default location where binaries will be stored.
  • node[:djbdns][:axfrdns_uid] - default uid for the axfrdns user
  • node[:djbdns][:dnscache_uid] - default uid for the dnscache user
  • node[:djbdns][:dnslog_uid] - default uid for the dnslog user
  • node[:djbdns][:tinydns_uid] - default uid for the tinydns user



The default recipe installs djbdns software from package where available, otherwise installs from source. It also sets up the users that will run the djbdns services using the UID's specified by the attributes above.


Creates the axfrdns user and sets up the axfrdns service.


Sets up a local DNS caching server.


Sets up a server to be an internal nameserver. To modify resource records in the environment, modify the tinydns-internal-data.erb template.


Sets up a server to be a public nameserver. To modify resource records in the environment, modify the tinydns-data.erb template.


Author:: Joshua Timberman (

Copyright 2009, Opscode, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Something went wrong with that request. Please try again.