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

Select Status

The samba-ad cookbook has been deprecated

Author provided reason for deprecation:

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

You may find that the samba cookbook is a suitable alternative.


samba-ad (2) Versions 0.0.2

Installs/Configures samba to use Active Directory via Kerberos

cookbook 'samba-ad', '= 0.0.2', :supermarket
cookbook 'samba-ad', '= 0.0.2'
knife supermarket install samba-ad
knife supermarket download samba-ad
Quality -%


Installs and configures Samba version 3 to work with kerberos and Windows active Directory


Assumes Samba version 3.

Should work on Debian-family, Red Hat-family and ArchLinux systems.

Uses Chef Server for data bag to build configuration file shares.

This cookbook connect to Windows Active Directory via Kerberos

The "/etc/samba/smbusers" file maps unix user names to Active Directory logons

The actual authentication is done by Kerberos


Does not (yet) integrate with LDAP/AD.

Uses plaintext passwords for the user data bag entry to create the SMB users if the password backend is tdbsam or smbpasswd. See below under usage.

Does not modify the Samba daemons to launch (i.e., ArchLinux's /etc/conf.d/samba SAMBA_DAMONS).


The attributes are used to set up the default values in the smb.conf, and set default locations used in the recipe. Where appropriate, the attributes use the default values in Samba.

  • node["samba"]["workgroup"] - The SMB workgroup to use, default "SAMBA".
  • node["samba"]["interfaces"] - Interfaces to listen on, default "lo".
  • node["samba"]["hosts_allow"] - Allowed hosts/networks, default "".
  • node["samba"]["bind_interfaces_only"] - Limit interfaces to serve SMB, default "no"
  • node["samba"]["server_string"] - Server string value, default "Samba Server".
  • node["samba"]["load_printers"] - Whether to load printers, default "no".
  • node["samba"]["passdb_backend"] - Which password backend to use, default "tdbsam".
  • node["samba"]["dns_proxy"] - Whether to search NetBIOS names through DNS, default "no".
  • node["samba"]["security"] - Samba security mode, default "user".
  • node["samba"]["map_to_guest"] - What Samba should do with logins that don't match Unix users, default "Bad User".
  • node["samba"]["socket_options"] - Socket options, default "TCP_NODELAY"
  • node["samba"]["config"] - Location of Samba configuration, default "/etc/samba/smb.conf".
  • node["samba"]["log_dir"] - Location of Samba logs, default "/var/log/samba/%m.log".



Installs smbclient to provide access to SMB shares.


Includes the client recipe by default.


Sets up a Samba server. See "Usage" below for more information.


The samba::default recipe includes samba::client, which simply installs smbclient package. Remaining information in this section pertains to samba::server recipe.

Set attributes as desired in a role, and create a data bag named samba with an item called shares. Also create a users data bag with an item for each user that should have access to samba.

Example data bag item for a single share named export in the shares item.

% cat data_bags/samba_shares/logs.json
  "id": "logs",
  "comment": "Everybody loves logs",
        "path": "/logs",
        "guest ok": "no",
        "printable": "no",
        "read list": [ "infosec" ],
        "write list": ["jtimberman"],
        "create mask": "0664",
        "directory mask": "0775"

Example data bag item for a user. Note that the user must exist on the system already. This is the minimal users data bag to set up the smbpasswd entry. More options are available for those using the users cookbook, see the readme for that cookbook for more information.

% cat data_bags/users/jtimberman.json
  "id": "jtimberman",
        "groups": [ "developers", "infosec" ],
        "ad_domain": "BIG_CORP_HQ"

License and Author

Author:: Bryan W. Berry (

Copyright:: 2011, Bryan W. Berry

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.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

No quality metric results found