31.01.2026

Debian Samba Setup: Complete Configuration Guide for Beginners

Intro

Samba is a powerful open-source solution for file and print sharing that implements the SMB/CIFS protocol, originally developed by Microsoft for Windows systems. It enables seamless file sharing between Linux and Windows machines within the same network.

In addition to basic file sharing, Samba supports user authentication, access control, printer sharing, and integration with Windows environments. In this beginner-friendly guide, you’ll learn how to install and configure Samba on Debian, create users, set up shared folders, and verify access from Linux and Windows clients.

Unlock the power of a stable, secure, and fully customizable VPS with AlmaLinux at Serverspace. Enjoy enterprise-grade performance, full root access, SSD storage, and global deployment options — all without licensing fees. Perfect for developers, businesses, and hosting professionals, our AlmaLinux VPS delivers predictable updates, CentOS compatibility, and effortless scalability. Launch your cloud server today and experience reliable, high-performance Linux hosting made simple.

Installing Samba on Debian

First, update the package index and install the Samba package on your Debian system.

sudo apt update
sudo apt install samba

Screenshot №1 — Installation

The command above will install necessary packages with their dependencies.

Manage Users

After the installation is complete, create a system user who will have access to the shared resources.Do it:

sudo useradd -m user1

Change "user1" with the actual username
Upon completion of the creation process, we should create a password:

sudo passwd user1

And then assign the Samba group:

sudo smbpasswd -a user1

Screenshot №2 — New user

Preparing Shared Directories

After creating and configuring users, we create shares to which they will have access. Create a folder share1 along the path / media

sudo mkdir /media/share1

Next, edit the Samba configuration file with a text editor, in this case nano:

sudo nano /etc/samba/smb.conf

It is used for creation shared folders, grant access to them, and other important service settings.
Now make new resource and define access rights to it.
Make a folder "share1", set permissions for user1:

[share1]
path = /media/share1
read only = no
guest ok = no
valid users = user1

Screenshot №3 — Configuration

After making these, directory "share1" will be accessible for user1.

Restart Samba

After changing the settings, the service should be restarted:

sudo systemctl restart smbd.service

Screenshot №4 — Status

This command will restart the Samba service and commit any changes made to the configuration.

Availability check

Once configured, you can test access to shared folders from another host on the network. To check from the server itself, you can use the smbclient utility, which should first be installed:

sudo apt install smbclient -y

Find your server’s IP address with command:

ip a

And then verify:

smbclient -U user1 //SERVER_IP/share1 -c 'ls'

Or by opening the file manager on another computer and typing in the address bar:

\\Debian_server_IP\share1

"Debian_server_IP" is the IP address of the newly configured server.
If everything was done correctly, then as a result you should see the contents of the "share1" folder. In the Windows you can use Explore.exe which have handler for SMB communications:

Screenshot №5 — Connection

Alright, after that we can use our shared folder under authenticated user1. For more control of user's action you can configure attributes for each! That solution also will be suitable for other distributives like alt Linux with Samba.

Security & Best Practices

You may be also interested in

FAQ

Conclusion

In this guide, we covered how to install and configure Samba on Debian, create users, set up shared directories, and verify access from Linux and Windows systems.

Samba is a reliable and flexible solution for file sharing in home and office networks. With proper user management and access control, it can serve as a secure and efficient Debian file server for cross-platform environments.