Docudjeex
Networking

Samba

Set up Samba on Debian to share folders over your local network and access them from Windows, macOS, or Linux.

Samba is a protocol that allows access to a folder located on a network drive. It can be configured on macOS, Windows, or Linux.

There are many tutorials for setting up Samba on Windows or on NAS systems like Synology, but here we focus on Debian.

Create and configure a Shared Network Folder

In this example, we will share the /video folder from a remote machine called remote-machine. We will access this folder from a machine called local-machine. The user connecting to the network drive will be sambauser.

Install Samba Server

Terminal
sudo apt update && sudo apt upgrade
sudo apt install samba smbclient cifs-utils

Create the /video Folder

Terminal
sudo mkdir /video

Configure the Share

Now, edit the file /etc/samba/smb.conf.

Terminal
sudo nano /etc/samba/smb.conf
Tip: You can use File Browser Quantum to navigate and edit your files instead of using terminal commands.

Find the workgroup variable and name your workgroup (e.g., workgroup = WORKGROUP).

Then scroll to the end of the file and add the following configuration:

smb.conf
[video]
   comment = Video folder
   path = /video
   writable = yes
   guest ok = no
   valid users = @smbshare
   force create mode = 770
   force directory mode = 770
   inherit permissions = yes

Press Ctrl+O, then Enter to save, and Ctrl+X to exit.

Done !

Create a Samba User and Group

Since we're using a secured share, we need to create a user and group to access it remotely.

Create the group

Terminal
sudo groupadd smbshare

Give the group control over the /video folder:

Terminal
sudo chgrp -R smbshare /video

Set inherited permissions:

Terminal
sudo chmod 2775 /video

Create the user

Now add a no-login user: this user cannot log into the server but can access Samba.

Terminal
sudo useradd -M -s /sbin/nologin sambauser

Add the user to the smbshare group:

Terminal
sudo usermod -aG smbshare sambauser

Set a Samba password:

Terminal
sudo smbpasswd -a sambauser

Enable the Samba account

Terminal
sudo smbpasswd -e sambauser

Done !

Accessing a Shared Folder

Install Required Packages

Terminal
sudo apt update && sudo apt upgrade
sudo apt install cifs-utils

Create the Mount Destination

We will create a folder on our local machine where the remote /video folder will be mounted, e.g. /mnt/video.

Terminal
sudo mkdir /mnt/video

Prepare the .credentials File

To avoid typing our username and password every time, create a .credentials file storing the login info.

Create it in the /smb folder:

Terminal
sudo mkdir /smb
sudo nano /smb/.credentials

Write:

.credentials
username=smbuser
password=password
  • smbuser: the user we created on the remote-machine
  • password: the password set earlier

Press Ctrl+O, then Enter to save, and Ctrl+X to exit.

Set proper file permissions:

Terminal
sudo chmod 600 /smb/.credentials

Mount the Shared Folder

Warning: If you're using ufw as firewall, you need to add a rule to allow your remote server to access to your share.
Terminal
sudo ufw allow from <your-remote-ip> to any app Samba

Now mount the folder:

Terminal
sudo mount -t cifs -o credentials=/smb/.credentials //remote-ip/video /mnt/video

Replace remote-ip with your remote-machine's IP address.

Verify the mount:

Terminal
sudo mount -t cifs

You’ll see details confirming the mount is successful.

Now you can access the /video folder of the remote-machine from your local-machine!

(Optional) Auto-mount on Boot

By default, shares aren't auto-mounted after reboot. To automate this, edit the /etc/fstab file.

First, back it up:

Terminal
sudo cp /etc/fstab /etc/fstab.bak

Then add the mount configuration line:

Terminal
sudo echo //remote-ip/video    /mnt/video  cifs   _netdev,nofail,credentials=/smb/.credentials,x-systemd.automount,x-systemd.device-timeout=15 0 0 >> /etc/fstab

Reboot the machine:

Terminal
sudo reboot

After rebooting, verify the mount:

Terminal
sudo mount -t cifs

And done!

Unmount the Shared Folder
Terminal
sudo umount -t cifs /mnt/video
Contributor:Djeex
Copyright © 2026