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

The locale cookbook has been deprecated

The locale cookbook has been deprecated and is no longer being maintained by its authors. Use of the locale cookbook is no longer recommended.


locale (7) Versions 2.1.0

Configures the system locale on Linux systems

cookbook 'locale', '~> 2.1.0'
cookbook 'locale', '~> 2.1.0', :supermarket
knife supermarket install locale
knife supermarket download locale
Quality 88%

locale cookbook

Build Status Cookbook Version

Sets the default system locale for this system. You can see which locales are available by running locale -a.

On Debian based systems, this recipe sets the locale by running update-locale and on Fedora, it uses localectl.

On RHEL based systems, the recipe operates on the /etc/sysconfig/i18n file directly because there is no standard command line tool to change the system locale settings.



  • Debian / Ubuntu derivatives
  • openSUSE / SUSE Linux Enterprises
  • RHEL/CentOS/Scientific/Amazon/Oracle
  • Fedora


  • Chef 12.7+


  • Include the cookbook in your metadata.
locale 'set locale' do
  lang 'en_gb.utf-8'
  lc_all 'en_gb.utf-8'


name type default value
lang String en_US.utf8
lc_all String en_US.utf8


This cookbook is maintained by Chef's Community Cookbook Engineering team. Our goal is to improve cookbook quality and to aid the community in contributing to cookbooks. To learn more about our team, process, and design goals see our team documentation. To learn more about contributing to cookbooks like this see our contributing documentation, or if you have general questions about this cookbook come chat with us in #cookbok-engineering on the Chef Community Slack


Copyright: 2016-2018, Chef Software, 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,
See the License for the specific language governing permissions and
limitations under the License.

locale Cookbook CHANGELOG

This file is used to list changes made in each version of the locale cookbook.

2.1.0 (2018-08-10)

  • Add a new locale resource, which is now the preferred way to use this resource. The recipe will continue to work, but in the future this resource will be included in chef-client and the cookbook will be deprecated. Thanks @damacus for this work.
  • Attempt to reload i18n content properly
  • Convert testing to Inspec
  • Require chef 12.7 or later
  • Don't check for LC_ALL on systemd based hosts
  • Avoid trying to set locale every time on systemd hosts

2.0.1 (2017-03-20)

  • Fix the version badge in the readme
  • Testing updates to check for Chef 13 compat
  • Test with Local Delivery and not Rake
  • Add a basic chefspec testing

2.0.0 (2016-09-09)

  • Require Chef 12.1
  • Add linting, unit and integration testing in Travis CI
  • Add contributing and testing docs
  • Add license file
  • Add maintainers files
  • Add oracle to the metadata
  • Update the readme with an expanded requirements section and license information
  • Don't both installing locales since the cookbook will never to to the package resource if locales isn't already installed

Collaborator Number Metric

2.1.0 passed this metric

Contributing File Metric

2.1.0 passed this metric

Foodcritic Metric

2.1.0 passed this metric

No Binaries Metric

2.1.0 passed this metric

Publish Metric

2.1.0 failed this metric

locale is deprecated

Supported Platforms Metric

2.1.0 passed this metric

Testing File Metric

2.1.0 passed this metric

Version Tag Metric

2.1.0 passed this metric