Forge Home


Controls samba server


8,991 latest version

1.9 quality score

Version information

  • 0.2.0 (latest)
  • 0.1.0 (deleted)
  • 0.0.1 (deleted)
released Mar 24th 2015

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'alkivi-samba', '0.2.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add alkivi-samba
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install alkivi-samba --version 0.2.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



alkivi/samba — version 0.2.0 Mar 24th 2015

Samba Module

This module will install and configure a samba (v3) server and allow you to add shares to it. If setup with ldap, it will created the correct association


Minimal server configuration

class { 'samba': 
  workgroup     => 'TEST',
  netbios_name  => 'TEST',
  server_strina => 'Awesome Test FileServer',

This will do the typical install, configure and service management.

Declaring one share

samba::share { 'homes': 
  options => { 
    'comment'        => 'Home Directories' ,
    'browseable'     => 'no' ,
    'read only'      => 'yes',
    'create mask'    => '0700',
    'directory mask' => '0700',
    'valid users'    => '%S',

So far, options key names are not checked, maybe in the futur ...

### Add ldap info to samba

class { 'samba::ldap':
  ldap_uri            => 'ldap://localhost',
  ldap_ssl            => 'no',
  ldap_delete_dn      => 'no',
  ldap_password_sync  => 'yes',
  ldap_admin_dna      => 'cn=admin,dc=test',
  ldap_suffix         => 'dc=test',
  ldap_user_suffix    => 'ou=people',
  ldap_group_suffix   => 'ou=groups',
  ldap_machine_suffix => 'ou=computers',
  ldap_idmap_suffix   => 'ou=idmap',

This add a fragment to smb.conf to handle ldap mapping ... a lot of parameter are still static thought


  • This module has been tested on Debian Wheezy, Squeeze.


All the code is freely distributable under the terms of the LGPLv3 license.


Need help ?


Please log tickets and issues at our Github