Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status


fqdn (3) Versions 0.2.0

Installs/Configures fqdn

cookbook 'fqdn', '= 0.2.0', :supermarket
cookbook 'fqdn', '= 0.2.0'
knife supermarket install fqdn
knife supermarket download fqdn
Quality -%

fqdn cookbook


This cookbook is not yet ready for use in production. It should only
be used in testing situations such as cookbook development.
Specifically, the line editing library it depends on contains bugs
and will edit files over multiple runs in certain circumstances.


There is an unfortunate amount of confusion and misunderstanding
around the term FQDN. The acronym stands for "Fully Qualified Domain
Name". This leads to some confusion about the relationship between it
and a hostname. It would be better called "Fully Qualified DNS Host Name".

On linux, it is found by issuing the command hostname -f. On
Solaris, there is no such thing, but you can set a dnsdomain name.

Linux will only return data when the proper bits are aligned in
/etc/hosts. The order of these bits need to be in is determined by the
version of glibc on the system. Solaris works a different way. Don't
even get me started on Windows.

How this gets set initially comes from many different directions. Some
Enterprises will keep a standard naming scheme and inject hostnames
and fqdns into hosts during provisioning. Some Cloud providers will
supply you with forward and reverse DNS, visible from the running
system. Some wont. Sometimes you get a machine who's hostname is set to
"computer" with no notion of being on a DNS domain at all.

Lots of server software breaks when a machine's FQDN is not properly
set. Chef recipes that refer to the FQDN attribute will error Ohai is
unable to determine what the FQDN should be.

Frankly, the whole thing is a mess.

This cookbook aims to easily set an FQDN on machines where it is not
properly set out of the box.


default['machine_fqdn'] = nil
default['machine_fqdn_as_hostname'] = true


If included in the run_list, fqdn::default will attempt to repair
the machine's FQDN based on user supplied data. If the attribute
node['machine_fqdn'] is set, it will use the string found there to
attempt to configuration the machine's hostname.

If node['machine_fqdn_as_hostname'] is set to true (it is by default),
it will configure the machine such that the hostname command returns
the full DNS path to the machine. That is, hostname and hostname
will return the same things on Linux machines.


line cookbook
hostsfile cookbook


include_recipe 'fqdn'




Author:: Sean OMeara (

Dependent cookbooks

line >= 0.0.0
hostsfile >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

No quality metric results found