Installs/Configures locale
Ruby Shell
Switch branches/tags

README.md

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.

Requirements

Platforms

  • Debian/Ubuntu
  • RHEL or derivatives
  • Fedora

Chef

  • Chef 12.1+

Cookbooks

  • none

Attributes

  • node['locale']['lang'] -- the value for "LANG": defaults to "en_US.utf8"
  • node['locale']['lc_all'] -- the value for "LC_ALL": defaults to "en_US.utf8"

Note that you cannot set "LC_ALL" on Fedora. It is a documented limitation; see "man 5 locale.conf". So this recipe simply ignores LC_ALL for Fedora.

Usage

Include the default recipe in your run list.

License & Authors

Author: Cookbook Engineering Team (cookbooks@chef.io)

Copyright: 2016, 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

    http://www.apache.org/licenses/LICENSE-2.0

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.