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 supermarket mailing list.

Select Badges

Select Supported Platforms


timezone-ii (1) Versions 0.2.0

Configure the system timezone on Linux systems

cookbook 'timezone-ii', '~> 0.2.0'
cookbook 'timezone-ii', '~> 0.2.0', :supermarket
knife cookbook site install timezone-ii
knife cookbook site download timezone-ii

Timezone II

The Timezone II cookbook contains recipes for installing the latest tzdata (a.k.a. IANA or Olson) timezone database and setting the timezone on your system. It is a fork of the timezone cookbook by James Harton.


This cookbook is known to work with:

  • Amazon Linux
  • CentOS
  • Debian
  • Fedora
  • Gentoo
  • Ubuntu

It should work with any OS that uses the IANA/Olson timezone database and stores local timezone data in /etc/localtime (the only OS I know of that does not do this is MS Windows). However, some OSs not mentioned above have their own system utility for setting the timezone, and this may overwrite the changes made by this cookbook.


<table> <tr> <th>Key</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> <tr> <td><tt>['tz']</tt></td> <td>String</td> <td>the timezone name as defined in tzdata</td> <td>UTC</td> </tr> <tr> <td><tt>['timezone']['tzdata_dir']</tt></td> <td>String</td> <td>the path to the root of the tzdata files; the default value is for most known distributions of Linux</td> <td>/usr/share/zoneinfo</td> </tr> <tr> <td><tt>['timezone']['localtime_path']</tt></td> <td>String</td> <td>the path to the file used by the kernel to read the local timezone's settings; the default works for Linux and other *ix variants</td> <td>/etc/localtime</td> </tr> <tr> <td><tt>['timezone']['use_symlink']</tt></td> <td>Boolean</td> <td>whether to use a symlink into the tzdata tree rather than make a copy of the appropriate timezone data file (linux-generic recipe only)</td> <td>false</td> </tr> </table>


Set the "tz" attribute to your desired timezone and include the "timezone-ii" recipe in your node's run list:

  "name": "my_node",
  "tz": "Africa/Timbuktu",
  "run_list": [

The timezone-ii::default recipe will first install or upgrade the IANA/Olson timezone database package for your OS (timezone-data on Gentoo, tzdata on all others). Then it will call one of the following recipes according to your node's platform:

  • timezone-ii::debian
  • timezone-ii::fedora
  • timezone-ii::linux-generic


  1. Fork the repository on GitHub
  2. Create a named feature branch (like add_component_x)
  3. Write your change
  4. If at all possible, write test-kitchen tests for your change and ensure they all pass
  5. Submit a pull request using GitHub

License and Authors

Copyright © 2010 James Harton

Copyright © 2013 Lawrence Leonard Gilbert

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.

No quality metric results found