add user script

This is the full pathname to a script that will be run AS ROOT by smbd 8 under special circumstances described below.
Normally, a Samba server requires that UNIX users are created for all users accessing files on this server. For sites that use Windows NT account databases as their primary user database creating these users and keeping the user list in sync with the Windows NT PDC is an onerous task. This option allows smbd to create the required UNIX users ON DEMAND when a user accesses the Samba server.
When the Windows user attempts to access the Samba server, at login (session setup in the SMB protocol) time, smbd 8 contacts the and attempts to authenticate the given user with the given password. If the authentication succeeds then smbd attempts to find a UNIX user in the UNIX password database to map the Windows user into. If this lookup fails, and is set then smbd will call the specified script AS ROOT, expanding any %u argument to be the user name to create.
If this script successfully creates the user then smbd will continue on as though the UNIX user already existed. In this way, UNIX users are dynamically created to match existing Windows NT accounts.
See also , , .

Example: /usr/local/samba/bin/add_user %u

Supported on: At least Microsoft Windows 7 or Windows Server 2008 family

add user script

Registry PathSoftware\Policies\Samba\smb_conf\add user script
Value Nameadd user script
Value TypeREG_SZ
Default Value


Administrative Templates (Computers)