1 # This is the main Samba configuration file. For detailed information about the
2 # options listed here, refer to the smb.conf(5) manual page. Samba has a huge
3 # number of configurable options, most of which are not shown in this example.
5 # The Official Samba 3.2.x HOWTO and Reference Guide contains step-by-step
6 # guides for installing, configuring, and using Samba:
7 # http://www.samba.org/samba/docs/Samba-HOWTO-Collection.pdf
9 # The Samba-3 by Example guide has working examples for smb.conf. This guide is
10 # generated daily: http://www.samba.org/samba/docs/Samba-Guide.pdf
12 # In this file, lines starting with a semicolon (;) or a hash (#) are
13 # comments and are ignored. This file uses hashes to denote commentary and
14 # semicolons for parts of the file you may wish to configure.
16 # Note: Run the "testparm" command after modifying this file to check for basic
20 # Security-Enhanced Linux (SELinux) Notes:
22 # Turn the samba_domain_controller Boolean on to allow Samba to use the useradd
23 # and groupadd family of binaries. Run the following command as the root user to
24 # turn this Boolean on:
25 # setsebool -P samba_domain_controller on
27 # Turn the samba_enable_home_dirs Boolean on if you want to share home
28 # directories via Samba. Run the following command as the root user to turn this
30 # setsebool -P samba_enable_home_dirs on
32 # If you create a new directory, such as a new top-level directory, label it
33 # with samba_share_t so that SELinux allows Samba to read and write to it. Do
34 # not label system directories, such as /etc/ and /home/, with samba_share_t, as
35 # such directories should already have an SELinux label.
37 # Run the "ls -ldZ /path/to/directory" command to view the current SELinux
38 # label for a given directory.
40 # Set SELinux labels only on files and directories you have created. Use the
41 # chcon command to temporarily change a label:
42 # chcon -t samba_share_t /path/to/directory
44 # Changes made via chcon are lost when the file system is relabeled or commands
45 # such as restorecon are run.
47 # Use the samba_export_all_ro or samba_export_all_rw Boolean to share system
48 # directories. To share such directories and only allow read-only permissions:
49 # setsebool -P samba_export_all_ro on
50 # To share such directories and allow read and write permissions:
51 # setsebool -P samba_export_all_rw on
53 # To run scripts (preexec/root prexec/print command/...), copy them to the
54 # /var/lib/samba/scripts/ directory so that SELinux will allow smbd to run them.
55 # Note that if you move the scripts to /var/lib/samba/scripts/, they retain
56 # their existing SELinux labels, which may be labels that SELinux does not allow
57 # smbd to run. Copying the scripts will result in the correct SELinux labels.
58 # Run the "restorecon -R -v /var/lib/samba/scripts" command as the root user to
59 # apply the correct SELinux labels to these files.
63 #======================= Global Settings =====================================
67 # ----------------------- Network-Related Options -------------------------
69 # workgroup = the Windows NT domain name or workgroup name, for example, MYGROUP.
71 # server string = the equivalent of the Windows NT Description field.
73 # netbios name = used to specify a server name that is not tied to the hostname.
75 # interfaces = used to configure Samba to listen on multiple network interfaces.
76 # If you have multiple interfaces, you can use the "interfaces =" option to
77 # configure which of those interfaces Samba listens on. Never omit the localhost
80 # hosts allow = the hosts allowed to connect. This option can also be used on a
83 # hosts deny = the hosts not allowed to connect. This option can also be used on
86 # max protocol = used to define the supported protocol. The default is NT1. You
87 # can set it to SMB2 if you want experimental SMB2 support.
90 server string = Samba Server Version %v
92 ; netbios name = MYSERVER
94 ; interfaces = lo eth0 192.168.12.2/24 192.168.13.2/24
95 ; hosts allow = 127. 192.168.12. 192.168.13.
99 # --------------------------- Logging Options -----------------------------
101 # log file = specify where log files are written to and how they are split.
103 # max log size = specify the maximum size log files are allowed to reach. Log
104 # files are rotated when they reach the size specified with "max log size".
107 # log files split per-machine:
108 log file = /var/log/samba/log.%m
109 # maximum size of 50KB per log file, then rotate:
112 # ----------------------- Standalone Server Options ------------------------
114 # security = the mode Samba runs in. This can be set to user, share
115 # (deprecated), or server (deprecated).
117 # passdb backend = the backend used to store user information in. New
118 # installations should use either tdbsam or ldapsam. No additional configuration
119 # is required for tdbsam. The "smbpasswd" utility is available for backwards
124 passdb backend = tdbsam
127 # ----------------------- Domain Members Options ------------------------
129 # security = must be set to domain or ads.
131 # passdb backend = the backend used to store user information in. New
132 # installations should use either tdbsam or ldapsam. No additional configuration
133 # is required for tdbsam. The "smbpasswd" utility is available for backwards
136 # realm = only use the realm option when the "security = ads" option is set.
137 # The realm option specifies the Active Directory realm the host is a part of.
139 # password server = only use this option when the "security = server"
140 # option is set, or if you cannot use DNS to locate a Domain Controller. The
141 # argument list can include My_PDC_Name, [My_BDC_Name], and [My_Next_BDC_Name]:
143 # password server = My_PDC_Name [My_BDC_Name] [My_Next_BDC_Name]
145 # Use "password server = *" to automatically locate Domain Controllers.
148 ; passdb backend = tdbsam
151 ; password server = <NT-Server-Name>
153 # ----------------------- Domain Controller Options ------------------------
155 # security = must be set to user for domain controllers.
157 # passdb backend = the backend used to store user information in. New
158 # installations should use either tdbsam or ldapsam. No additional configuration
159 # is required for tdbsam. The "smbpasswd" utility is available for backwards
162 # domain master = specifies Samba to be the Domain Master Browser, allowing
163 # Samba to collate browse lists between subnets. Do not use the "domain master"
164 # option if you already have a Windows NT domain controller performing this task.
166 # domain logons = allows Samba to provide a network logon service for Windows
169 # logon script = specifies a script to run at login time on the client. These
170 # scripts must be provided in a share named NETLOGON.
172 # logon path = specifies (with a UNC path) where user profiles are stored.
176 ; passdb backend = tdbsam
178 ; domain master = yes
179 ; domain logons = yes
181 # the following login script name is determined by the machine name
183 ; logon script = %m.bat
184 # the following login script name is determined by the UNIX user used:
185 ; logon script = %u.bat
186 ; logon path = \\%L\Profiles\%u
187 # use an empty path to disable profile support:
190 # various scripts can be used on a domain controller or a stand-alone
191 # machine to add or delete corresponding UNIX accounts:
193 ; add user script = /usr/sbin/useradd "%u" -n -g users
194 ; add group script = /usr/sbin/groupadd "%g"
195 ; add machine script = /usr/sbin/useradd -n -c "Workstation (%u)" -M -d /nohome -s /bin/false "%u"
196 ; delete user script = /usr/sbin/userdel "%u"
197 ; delete user from group script = /usr/sbin/userdel "%u" "%g"
198 ; delete group script = /usr/sbin/groupdel "%g"
201 # ----------------------- Browser Control Options ----------------------------
203 # local master = when set to no, Samba does not become the master browser on
204 # your network. When set to yes, normal election rules apply.
206 # os level = determines the precedence the server has in master browser
207 # elections. The default value should be reasonable.
209 # preferred master = when set to yes, Samba forces a local browser election at
210 # start up (and gives itself a slightly higher chance of winning the election).
214 ; preferred master = yes
216 #----------------------------- Name Resolution -------------------------------
218 # This section details the support for the Windows Internet Name Service (WINS).
220 # Note: Samba can be either a WINS server or a WINS client, but not both.
222 # wins support = when set to yes, the NMBD component of Samba enables its WINS
225 # wins server = tells the NMBD component of Samba to be a WINS client.
227 # wins proxy = when set to yes, Samba answers name resolution queries on behalf
228 # of a non WINS capable client. For this to work, there must be at least one
229 # WINS server on the network. The default is no.
231 # dns proxy = when set to yes, Samba attempts to resolve NetBIOS names via DNS
235 ; wins server = w.x.y.z
240 # --------------------------- Printing Options -----------------------------
242 # The options in this section allow you to configure a non-default printing
245 # load printers = when set you yes, the list of printers is automatically
246 # loaded, rather than setting them up individually.
248 # cups options = allows you to pass options to the CUPS library. Setting this
249 # option to raw, for example, allows you to use drivers on your Windows clients.
251 # printcap name = used to specify an alternative printcap file.
257 ; printcap name = /etc/printcap
258 # obtain a list of printers automatically on UNIX System V systems:
259 ; printcap name = lpstat
262 # --------------------------- File System Options ---------------------------
264 # The options in this section can be un-commented if the file system supports
265 # extended attributes, and those attributes are enabled (usually via the
266 # "user_xattr" mount option). These options allow the administrator to specify
267 # that DOS attributes are stored in extended attributes and also make sure that
268 # Samba does not change the permission bits.
270 # Note: These options can be used on a per-share basis. Setting them globally
271 # (in the [global] section) makes them the default for all shares.
277 ; store dos attributes = yes
280 #============================ Share Definitions ==============================
283 comment = Home Directories
287 ; valid users = MYDOMAIN\%S
290 comment = All Printers
291 path = /var/spool/samba
297 # Un-comment the following and create the netlogon directory for Domain Logons:
299 ; comment = Network Logon Service
300 ; path = /var/lib/samba/netlogon
305 # Un-comment the following to provide a specific roving profile share.
306 # The default is to use the user's home directory:
308 ; path = /var/lib/samba/profiles
312 # A publicly accessible directory that is read only, except for users in the
313 # "staff" group (which have write permissions):
315 ; comment = Public Stuff
320 ; write list = +staff