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


exim4-light (4) Versions 0.1.3

Installs and configures exim4-light.

cookbook 'exim4-light', '~> 0.1.3'
cookbook 'exim4-light', '~> 0.1.3', :supermarket
knife cookbook site install exim4-light
knife cookbook site download exim4-light


This cookbook installs and configures exim4 for client or outbound relayhost.

Build Status



  • Debian 6.0+

May work on other platforms with or without modification.


See attributes/default.rb for default values.

  • node['exim4']['user'] - The exim4 user.
  • node['exim4']['configtype'] - The main configuration type. One of internet, smarthost, satellite, local or none.
  • node['exim4']['other_hostnames']- Is used to build the local_domains list, together with `localhost. This is the list of domains for which this machine should consider itself the final destination.
  • node['exim4']['local_interfaces']- List of IP addresses the Exim daemon should listen on. If this is left empty, Exim listens on all interfaces.
  • node['exim4']['readhost']- For smarthost and satellite it is possible to hide the local mailname in the headers of outgoing mail and replace it with this value instead, using rewriting.
  • node['exim4']['relay_domains']- Is a list of domains for which we accept mail from anywhere on the Internet but which are not delivered locally, e.g. because this machine serves as secondary MX for these domains.
  • node['exim4']['minimaldns']- Boolean option to activate some option to minimize DNS lookups.
  • node['exim4']['relay_nets']- A list of machines for which we serve as smarthost. Please note that and ::1 are always permitted to relay since /usr/lib/sendmail is available anyway and relay control doesn't make sense here.
  • node['exim4']['use_split_config']- Boolean option that controls whether update-exim4.conf uses /etc/exim4/exim4.conf.template (false) or the multiple files below /etc/exim4/conf.d (true) as input.
  • node['exim4']['hide_mailname']- Boolean option that controls whether the local mailname in the headers of outgoing mail should be hidden. (Only effective for smarthost and satellite.
  • node['exim4']['localdelivery']- Name of the default transport for local mail delivery. Defaults to mail_spool if unset, use maildir_home for delivery to ~/Maildir/.
  • node['exim4']['smarthost_server']- Server to which all outgoing mail is passed to and that takes care of delivering it. All deliveries go out to TCP port 25 unless a different port is specified (use smarthost_port). Colons in IPv6 addresses need to be doubled. If a port number follows, IP addresses may be enclosed in brackets, which might be the only possibility to specify delivery to an IPv6 address and a different port.
  • node['exim4'][smarthost_port] - TCP port for the mail server. If no port is given exim uses 25 by default.
  • node['exim4']['smarthost_login']- Login used for the smarthost.
  • node['exim4']['smarthost_pwd']- Password used for the smarthost.
  • node['exim4']['encrypted']['enabled']- Enable usage of encrypted data bag for smarthost credentials.
  • node['exim4']['encrypted']['bag']- Name of the encrypted data bag.
  • node['exim4']['encrypted']['item']- Name of the encrypted data bag item.
  • node['exim4']['other_options'] - Hash of other options for update-exim4.conf.conf.


Include the recipe[exim4-light] in your node or role runlist. By default exim4 will be unconfigured. Set at least the node['exim4']['configtype'].

It is recommended to use an encrypted data bag to store your credentials. To enable this feature, set node['exim4']['encrypted']['enabled'] to true and set the data bag and item names accordingly.

License and Author

Author:: Thomas Massmann

Copyright:: 2012-2013, Thomas Massmann

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

There are no cookbooks that are contingent upon this one.

CHANGELOG for exim4-light

This file is used to list changes made in each version of exim4-light.


  • Initial release of exim4-light


  • Fix improper settings to passwd.client when using custom port for smarthost. Thanks to ifeltsweet.


  • Fixed some minor syntax errors.
  • Added basic kitchen tests.
  • You can now use encrypted data bags for your credentials.


  • Added ability to add other options to update-exim4.conf.conf. Thanks to cyberflow

Collaborator Number Metric

0.1.3 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

0.1.3 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Foodcritic Metric

0.1.3 failed this metric

FC064: Ensure issues_url is set in metadata: exim4-light/metadata.rb:1
FC065: Ensure source_url is set in metadata: exim4-light/metadata.rb:1
FC066: Ensure chef_version is set in metadata: exim4-light/metadata.rb:1
FC069: Ensure standardized license defined in metadata: exim4-light/metadata.rb:1
FC072: Metadata should not contain "attribute" keyword: exim4-light/metadata.rb:1
Run with Foodcritic Version 11.1.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

License Metric

0.1.3 failed this metric

exim4-light does not have a valid open source license.
Acceptable licenses include Apache-2.0, apachev2, Apache 2.0, MIT, mit, GPL-2.0, gplv2, GNU Public License 2.0, GPL-3.0, gplv3, GNU Public License 3.0.

No Binaries Metric

0.1.3 passed this metric

Publish Metric

0.1.3 passed this metric

Supported Platforms Metric

0.1.3 passed this metric

Testing File Metric

0.1.3 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

0.1.3 passed this metric