Project

General

Profile

Actions

Setting up the smbconf file » History » Revision 5

« Previous | Revision 5/9 (diff) | Next »
Gareth Eaton, 12/16/2023 04:17 PM


Setting up the smbconf file

MORE

Setting up the smb.conf file for Samba involves configuring the various parameters that define the behavior of your Samba server, including the shared directories, authentication settings, and security options. Here's a basic guide on how to set up the smb.conf file:

Backup Your Existing Configuration (Optional):

Before making changes, it's a good practice to back up your existing smb.conf file in case something goes wrong. You can do this with the following command:

sudo cp /etc/samba/smb.conf /etc/samba/smb.conf.backup

Open the smb.conf File for Editing:

You can use your preferred text editor to edit the smb.conf file. For example, you can use the nano text editor with the following command:

sudo nano /etc/samba/smb.conf

Configure Global Settings:

The smb.conf file starts with global settings that apply to the entire Samba server. Some common global settings include:

[global]
workgroup = WORKGROUP
server string = Samba Server
security = user
encrypt passwords = yes

workgroup: Set your workgroup or domain name.
server string: A description of your Samba server.
security: Set to "user" for user-level security.
encrypt passwords: Enable password encryption.

Define Shares: More

Below the global settings, you can define the shared directories by adding sections like this:

[ShareName]
path = /path/to/shared/folder
valid users = user1, user2
read only = no

ShareName: Choose a name for your share.
path: Specify the path to the directory you want to share.
valid users: List the users who are allowed to access this share.
read only: Set to "yes" for read-only access or "no" for read-write access.

Configure Share-specific Settings :

You can also set specific options for each share. These settings can include access control, guest access, and more.

Save and Close the smb.conf File:

After making your changes, save the smb.conf file and exit your text editor.

Test the Configuration:

Before restarting Samba, it's a good idea to test the configuration for syntax errors:

testparm

Restart Samba:

After verifying the configuration, restart the Samba service for the changes to take effect:

sudo systemctl restart smbd

Set Samba Passwords:

Ensure that the users you've specified in the valid users parameter have Samba passwords set using the smbpasswd command.

Open Firewall Ports (if necessary):

If you have a firewall enabled, make sure to allow traffic on the necessary ports (e.g., TCP 139, 445) to allow Samba traffic.

Test Access:

Finally, test access to your Samba shares from client machines to make sure everything is working as expected.
This is a basic setup of the smb.conf file. Depending on your requirements, you may need to configure additional options such as user-level or share-level security, domain authentication, printer sharing, and more. Be sure to consult the Samba documentation and relevant resources for your specific use case.

Updated by Gareth Eaton 11 months ago · 5 revisions