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


bashrc (3) Versions 2.0.0

A resource to install a bash profile from

cookbook 'bashrc', '= 2.0.0'
cookbook 'bashrc', '= 2.0.0', :supermarket
knife supermarket install bashrc
knife supermarket download bashrc
Quality 100%

Fletcher Nichol's Bash Profile Chef Cookbook

Cookbook Version Build Status

A Chef cookbook containing a resource to install a bash profile from


Place a dependency on the bashrc cookbook in your cookbook's metadata.rb

depends "bashrc", "~> 2.0"

Then, to install systemwide, put the following in a recipe:

bashrc "root"

Or for a particular user:

bashrc "jdoe"

For a more complete example, checkout the provided example cookbook.


As of version 2.0.0, this cookbook is a library-style or resource-only cookbook. In other words, there are no recipes, attributes, etc. and you use the provded resource in your own cookbook. This helps keep dependencies and maintenance as low as possible.


  • Chef 0.10.2 or higher

Platform Support

This cookbook is tested on the following platforms with Test Kitchen:

  • CentOS 7.1 64-bit
  • Debian 8.1 64-bit
  • Mac OS X 10.9
  • Mac OS X 10.10
  • Ubuntu 12.04 64-bit
  • Ubuntu 14.04 64-bit
  • Ubuntu 15.04 64-bit

Cookbook Dependencies

This cookbook has no external cookbook dependencies.


This cookbook has no recipes.


This cookbook has no attributes.

Resources and Providers


The bashrc resource manages the installation of the bashrc profile for all users on the system when the root user is provided or can install it on a per-user basis.

The system-wide installation puts the profile under /etc/bash and the per-user installation puts the profile under the user's $HOME directory in .bash.

The :install action installs the profile, which is the default (and only) action.


bashrc "system-wide installation" do
  user "root"
  action :install

# short form of above example
bashrc "root"

bashrc "install only for jdoe user" do
  user "jdoe"
  action :install

# short form of above example
bashrc "jdoe"

Note that for per-user installations, the user must already exist with their home directory created and appropriate permissions assigned (i.e. the user must be able to write in their own home directory).


  • user - The user that the profile will be installed under. If "root" is provided, a system-wide installation will be performed, setting up under /etc/bash. Defaults to the resource name.


  • :install - Downloads, extracts, and initializes the profile for the given user.


Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every seperate change you make.

License and Author

Author:: Fletcher Nichol ( endorse


Copyright:: 2010, 2011, 2015 Fletcher Nichol

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.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

ut_workstation Applicable Versions

2.0.0 / 2015-08-09

Major, breaking release, see for usage details.

0.3.4 / 2013-07-05

Bug fixes

  • Fix bashrc install when invoked non-interactively. (@fnichol)

0.3.2 / 2013-07-04


  • Fix bashrc_update when invoked non-interactively. (@fnichol)

0.3.0 / 2013-07-04

Bug fixes


0.2.2 / 2011-11-06

The initial release.

<!--- The following link definition list is generated by PimpMyChangelog --->

Foodcritic Metric

2.0.0 passed this metric