Oct 23, 2023 10 min read

How to Install and Configure Samba on Ubuntu 20.04

Install and Configure Samba on Ubuntu 20.04 with our step-by-step tutorial. It is open-source software for cross-platform file sharing.

Install and Configure Samba on Ubuntu 20.04
Table of Contents

Choose a different version or distribution


Before we begin talking about how to install Samba and configure it on Ubuntu 20.04, let's understand - What is Samba?

Samba is open-source software for cross-platform file sharing. It is a powerful open-source software suite that allows file sharing and resource sharing between different operating systems. It enables seamless communication between Windows, Linux, and Unix systems.

By using the Server Message Block (SMB) protocol, Samba helps to create a network environment where files, printers, and other resources can be easily accessed by computers within the network. Discover the benefits of Samba for efficient cross-platform collaboration and resource sharing.

In this tutorial, you will install Samba on Ubuntu 20.04 and configure it in the form of a standalone server to enable sharing of documents and files across multiple OSs across a network. Also, we will answer some FAQs regarding the Docker Compose installation.

Advantages of Samba

  1. Cross-platform compatibility: Samba enables file and resource sharing between different operating systems like Windows, Linux, and Unix.
  2. Seamless integration: It provides smooth communication and collaboration between different platforms, fostering productivity.
  3. Cost-effective solution: Samba is open-source, eliminating the need for costly licenses.
  4. Enhanced file sharing: Users can easily access files, printers, and other resources within the network environment.
  5. Flexibility and scalability: Samba is highly customizable, allowing for easy configuration and adaptation to varying network requirements.

To start off, you need to generate these Samba shares and users.


  • sadmin - An administrative user who has read and write access to everything which is shared.
  • josh - A regular user that has its own private documents and files.


  • users - This share can be accessed by all users and every user has read and write permission.
  • josh - This share can be accessed by only sadmin and josh and only they possess the permission to read or write.

The shared documents and files could be accessed by each and every device on the network. In the second part of this tutorial, we shall go through the procedure to connect to the Samba server on Linux, Windows, and macOS clients.


Prior to moving further, do ensure that you are logged on to your Ubuntu 20.04 system with sudo privileges.

Step 1 - Installing Samba on Ubuntu

Samba can be found at official Ubuntu repositories. In order to install it on the Ubuntu system, carefully follow the following instructions:

1) Initiate the process by updating the apt packages index:

sudo apt update

2) Install Samba package using this:

sudo apt install samba

3) After installation, the Samba service will be operative. To verify if the Samba server is running or not, use the below command:

sudo systemctl status smbd

This output will appear to show that the Samba service is activated:


● smbd.service - Samba SMB Daemon
   Loaded: loaded (/lib/systemd/system/smbd.service; enabled; vendor preset: enabled)
   Active: active (running) since Wed 2019-11-27 09:25:38 UTC; 2min 12s ago
     Docs: man:smbd(8)
 Main PID: 15142 (smbd)
   Status: "smbd: ready to serve connections..."
    Tasks: 4 (limit: 1152)
   CGroup: /system.slice/smbd.service

Now, Samba is installed and can be configured.

Step 2 - Configuring firewall

In case, there is a firewall running on the Ubuntu system, grant permission to incoming UDP connections on ports 137 and 138 and TCP connections on ports 139 and 445.

1) Presuming that UFW is being used to manage the firewall, open the ports by allowing the ‘Samba’ profile:

sudo ufw allow 'Samba'

Step 3 - Configuring Global Samba Options

1) Prior to effecting any changes to the Samba configuration file, make a backup for reference purposes in the future:

sudo cp /etc/samba/smb.conf{,.backup}

2) At this point, the default configuration file which comes alongside the Samba package has been configured for a standalone Samba server. Open the file and ensure that server role is set to standalone server by using this:

sudo nano /etc/samba/smb.conf
# Most people will want "standalone sever" or "member server".
# Running as "active directory domain controller" will require first
# running "samba-tool domain provision" to wipe databases and create a
# new domain.
   server role = standalone server

3) By default, Samba operates on each and every interface. In case you desire to restrict access to the Samba server only on the internal network then uncomment the following two lines and specify the interfaces to bind to:

# The specific set of interfaces / networks to bind to
# This can be either the interface name or an IP address/netmask;
# interface names are normally preferred
interfaces = eth0

# Only bind to the named interfaces and/or networks; you must use the
# 'interfaces' option above to use this.
# It is recommended that you enable this feature if your Samba machine is
# not protected by a firewall or is a firewall itself.  However, this
# option cannot handle dynamic or non-broadcast interfaces correctly.
bind interfaces only = yes

4) After completion, run the testparm utility to verify the Samba configuration file and ensure that it's error-free. In case there are no syntax errors Loaded services file OK. will appear.

Lastly, restart the Samba services with:

sudo systemctl restart smbd

Step 4 - Creating Samba Users and Directory Structure

1) To manage easily instead of utilizing the standard home directories (/home/user) each and every Samba directories and data will be located in the /samba directory.

In order to create the /samba directory use the following command:

sudo mkdir /samba

2) Then make sure that group ownership is set to sambashare. While the Samba installation, this group is created, and later you will add all Samba users here.

sudo chgrp sambashare /samba

3) Samba utilizes Linux users and a group permission system. Although it has an authentication mechanism of its own as well. One may create users through the standard Linux useradd tool and later on set the password of the user via smbpasswd utility.

4) Following step is to create a regular user that can access private file share and a single administrative account with read/write permission to all shares on the Samba server.

Step 5 - Creating Samba Users

1) For creating a new user named josh, run this:

sudo useradd -M -d /samba/josh -s /usr/sbin/nologin -G sambashare josh

2) The useradd options mean the following:

  • -M - do not create the user’s home directory, you will manually create this directory.
  • -d /samba/josh - set the user’s home directory to /samba/josh.
  • -s /usr/sbin/nologin - disable shell access to this user.
  • -G sambashare - add the user to the sambashare group.

Following this, create a user’s home directory and set the directory ownership to user josh and group sambashare using this command:

sudo mkdir /samba/josh

3) This next command would add the setgid bit to the /samba/josh directory and hence, the files created recently in the directory will inherit the group of the parent directory. This ensures that if a user creates a new file the file will have a group-owner of sambashare.

sudo chmod 2770 /samba/josh

4) Then, josh user account is to be added to the Samba database and can be done by setting the user password:

sudo smbpasswd -a josh

Once the command is run you would be prompted to put the user password.


New SMB password:
Retype new SMB password:
Added user josh.

5) After setting the password, to activate the Samba account run:

sudo smbpasswd -e josh

Enabled user josh.

6) For creating another user, carry out the same process which you would for creating the user josh.

Now, follow these steps to create a user and group sadmin. Each and every member of this group has administrative permissions. In case, you desire to grant administrative permissions to any other user, just add that user to the sadmin group.

7) For creating the administrative user, use this:

sudo useradd -M -d /samba/users -s /usr/sbin/nologin -G sambashare sadmin

8) The aforementioned command shall also create a group sadmin and add the user to both sadmin and sambashare groups.

9) The next step is to set the password and allow the user:

sudo smbpasswd -a sadmin

10) After this, you need to create the Users share directory:

sudo mkdir /samba/users

11) Then you have to set directory ownership to the user sadmin and group sambashare by using this command:

sudo chown sadmin:sambashare /samba/users

12) This directory can be accessed by each and every authenticated user. The next chmod command provides write/read access to members of the sambashare group in the /samba/users directory:

sudo chmod 2770 /samba/users

Step 6 - Configuring Samba Shares

1) For this, the Samba configuration file is to be opened first, and then you must append the sections:

sudo nano /etc/samba/smb.conf
    path = /samba/users
    browseable = yes
    read only = no
    force create mode = 0660
    force directory mode = 2770
    valid users = @sambashare @sadmin

    path = /samba/josh
    browseable = no
    read only = no
    force create mode = 0660
    force directory mode = 2770
    valid users = josh @sadmin

These options have the meanings given below:

  • [users] and [josh] - The names of the shares to use when logging in.
  • path - The path to the share.
  • browseable -  If the share is to be listed in the list of the available shares. By setting to no, other users won't be able to see the share.
  • read only - If the users specified in the valid users list can write to this share.
  • force create mode - Sets the permissions for the files which are newly created.
  • force directory mode - Sets the permissions for the newly created directories in this share.
  • valid users - A list of users and groups that are allowed to access the share.

2) At this point, restart the Samba services using:

sudo systemctl restart smbd
sudo systemctl restart nmbd

In the next sections, we have discussed how to connect to a Samba share from Linux, macOS, and Windows clients.

Step 7 - Connecting to a Samba Share from Linux

Linux users can access the samba share from the command line, using the file manager, or mount the Samba share.

Step 8 - Using smbclient

smbclient is a tool that enables one to gain access to Samba from a command line. The smbclient package is not default on most Linux distros and thus, it is needed to be installed alongside the distribution package manager.

1) For installing smbclient on Ubuntu and Debian, use this command:

sudo apt install smbclient

2) For installing smbclient on CentOS and Fedora, use this:

sudo yum install samba-client

3) For accessing Samba share, use this:

mbclient //samba_hostname_or_server_ip/share_name -U username

4) For instance, in order to connect to a share named josh on a Samba server with an IP address as user josh, you need to use the command:

smbclient // -U josh

5) Then, you have to enter the user password.


Enter WORKGROUP\josh's password:

6) After entering the password, you are into the Samba command-line interface.


Try "help" to get a list of possible commands.
smb: \>

Step 9 - Mounting the Samba share

For mounting Samba share to Linux, you must install the cifs-utils package.

1) For Ubuntu and Debian, use:

sudo apt install cifs-utils

2) For CentOS and Fedora, use:

sudo yum install cifs-utils

3) Then, create the mount point using:

sudo mkdir /mnt/smbmount

4) After that, mount the share using:

sudo mount -t cifs -o username=username //samba_hostname_or_server_ip/sharename /mnt/smbmount

5) For instance, for mounting a share titled josh on a Samba server along with the IP address as user josh to the /mnt/smbmount mount point, use the following command:

sudo mount -t cifs -o username=josh // /mnt/smbmount

6) Then, this will appear and you will enter the user password.


Password for josh@//  ********

Step 10 - Using GUI

The default file manager in Gnome has a built-in option to access Samba shares.

  1. Open Files and click on “Other Locations” in the sidebar.
  2. In “Connect to Server”, put the address of the Samba share in this format smb://samba_hostname_or_server_ip/sharename.
  3. Then, click on “Connect”.
  4. The next step is to select “Registered User”, put the Samba username and password, and hit “Connect”.
  5. The files on the Samba server will appear.

Step 11 - Connecting to a Samba Share from macOS

For macOS, users could gain access to the Samba Shares through the command line or by resorting to the default macOS file manager which is "Finder". These instructions can be followed to access the share using Finder.

  1. Open “Finder”, choose the option “Go” and then click on “Connect To”.
  2. Under “Connect To”, you must put the address of the Samba share in this format: smb://samba_hostname_or_server_ip/sharename.
  3. Then hit “Connect”.
  4. Choose the “Registered User” option and then put the Samba username and password and hit “Connect”.
  5. The files on the Samba server will appear.

Step 12 - Connecting to a Samba Share from Windows

Windows users can also connect to the Samba share from, both, the command line and GUI. These are the steps to access the share utilizing the Windows File Explorer.

  1. Open the "File Explorer" and on the left-panel right-click on “This PC”.
  2. Find and select the option which says “Choose a custom network location” and then hit “Next”.
  3. In “Internet or network address”, put the address of the Samba share in this format: \\samba_hostname_or_server_ip\sharename.
  4. After hitting the option “Next” and you need to enter the login credentials.
  5. Then, in the following window, one may type a custom name associated with the network location. The Samba server will choose the default one.
  6. Hit “Next” for moving the last screen on the connection setup wizard.
  7. Finally, click on “Finish” then Samba server filed will appear.

FAQs to Install and Configure Samba on Ubuntu 20.04

How do I create a shared folder using Samba?

Edit the Samba configuration file and add a new entry specifying the folder's path, permissions, and access control.

How do I restart the Samba service after making configuration changes?

Use the command sudo service smbd restart to restart the Samba service.

How can I test the Samba configuration for errors?

Use the command testparm to check the Samba configuration file for any syntax or configuration errors.

How can I access a Samba share from Windows?

Open the Run dialog in Windows (Win+R), then enter \\<Ubuntu-IP>\<share-name> and press Enter.

How do I mount a Samba share on Ubuntu?

Use the command sudo mount -t cifs //<Samba-IP>/<share-name> /local-mount-point -o username=<samba-username>,password=<samba-password>


We hope this detailed guide helped you understand how to install and configure Samba. To learn more about Samba installation, check out the official Samba documentation.

If you have any queries, please leave a comment below and we’ll be happy to respond to them for sure.

Great! You’ve successfully signed up.
Welcome back! You've successfully signed in.
You've successfully subscribed to DevOps Tutorials - VegaStack.
Your link has expired.
Success! Check your email for magic link to sign-in.
Success! Your billing info has been updated.
Your billing was not updated.