The Ultimate Guide to Build a Personal Cross-Platform File Server on Raspberry Pi!

Arunkl
TheSecMaster
Published in
7 min readNov 10, 2022
An image of raspberry pi 4 with an external hard drive
Source: thesecmaster.com

Raspberry is such a powerful tiny computer you can use this as a tool for pretty much anything. Our focus in this article is to know how to build a personal cross-platform file server on Raspberry Pi. We are sure that after reading this article, you will be in a position to set up your Raspberry Pi as a fully functional file server on your home network.

There are multiple third-party tools in the market that allows you to set up your own file server. Some of them are free, and some may come for an extra cost. However, our goal is to let you know how to build a working file server by leveraging the service of simple SMB/CIFS protocols. We are using Samba to implement SMB/CIFS services to share the storage across the network. Along with this, we thought it would be good to share some information about file permissions on Linux. Let’s make a checklist of components we need to set up a file server.

Table of Contents· What Is Required to Build a File Server on a Raspberry Pi?
· What is Samba?
· How to Install Samba on Raspberry Pi?
· File System Permissions On Linux:
· How To Configure Samba To Share Directories On Raspberry Pi?
· Few tips:

What Is Required to Build a File Server on a Raspberry Pi?

  1. A running Raspberry Pi with Raspberry PI OS, Samba, and a couple of packages installed on it. Please check out our posts “How to set up a Raspberry Pi for the first time?” and “Five easiest ways to connect Raspberry Pi remotely in 2021:” if you are working on the Pi for the first time.
  2. Your choice of clean formatted and partitioned storage drives to connect to Pi. Please check out our post “How to Partition and Format the Hard Drives on Raspberry Pi?” to know more about adding a hard drive to Raspberry Pi.

What is Samba?

As the front page at samba.org says: Samba is a software package that gives network administrators flexibility and freedom in terms of setup, configuration, and choice of systems and equipment. Because of all that it offers, Samba has grown in popularity and continues to thrive every year since its release in 1992.

Samba is software used to implement Server Message Block (SMB) protocol. It’s used to share files over the network. It is also referred to as Common Internet File System, in short CIFS. If you ask what platforms support this protocol. The answer is pretty much all. It supports Windows, Linux, and Mac. What support you need else! With a couple of additional packages and a few configurations, you can build a personal cross-platform file-sharing server on Raspberry Pi at your home, which provides a central storage and is capable of sharing files with other computers, smart TV, smartphone, and other smart devices.

How to Install Samba on Raspberry Pi?

As Samba is available on the apt packages, you can directly install the package using apt-get. There are two different packages to install, so you can install both of them in a single command.

1. Install samba on Raspberry Pi.

$ sudo apt-get install samba samba-common-bin

Type ‘y’ and let the installation continue.

An image of installation of samba on Raspberry Pi
Install samba on Raspberry Pi

2. You may see this configuration wizard right before the installation. Choose ‘Yes’ if you already have a router which is serving as a DHCP server and disseminating IP addresses. Say ‘no’ if this is the only server running in your network. We are going to select ‘yes’ as we do have a router in our network.

An image setting up DHCP client on Raspberry Pi
Setting up DHCP client on Raspberry Pi

When the Samba installation gets completed, you will be ready to start setting up shares. Let’s assume we have created two partitions on our drive. One partition is created using NTFS, and the second is created using the EXT4 file system. And we have mounted both partitions under the/mnt/data-ntfs and /mnt/data-ext4 paths, respectively. If you do ls -l /mnt, this is how you should see. There is another dedicated post on how to partition the drive “How to Partition and Format the Hard Drives on Raspberry Pi?”. We recommend reading that post before you proceed.

This image is captured by the author

File System Permissions On Linux:

Although file permissions on Linux is a different topic, however, we would like to give you some heads up on this as it is required to understand if you are dealing with file sharing on Linux. In essence, there are three types of permission in Linux, Read, Write, and Execute. All three permission are applied to three types of user entities, Users, Groups, and Others.

  1. User: A user who created the file. You can call them the owner of the file, who has read, write and execute permission on their created files by default.
  2. group: In Linux, all files and directories will also have a group, a collection of users belonging to the group.
  3. Others: Finally, everyone else.

Now, pay some attention to the first few characters on both lines in the above-shown picture. They are a set of 10 characters segregated into four subsets, and They specify the permissions set on their files and directories.

  1. 1st char: ‘d’ represents its directory. In the case of any other files, you may see ‘-. ‘
  2. 2nd, 3rd, and 4th chars: Represents the Read ‘r,’ Write ‘w,’ and Execute ‘x’ permissions for the ‘User.’
  3. 5th, 6th, 7th chars: Represents the Read ‘r’, Write ‘w,’ and Execute ‘x’ permissions for the ‘Group’.
  4. 8th, 9th, 10th, char: Represents the Read ‘r,’ Write ‘w,’ and Execute ‘x’ permissions for the ‘Others.’

In the above picture, 1st char of both files are ‘d’, and it’s a directory. If you read the rest of the characters, you will come to know that the ext4 partition has all ‘rwx’ remissions for the ‘User’, only ‘r-x’ read and execute permissions for ‘Group’ and ‘Others’. Similarly, if you read the remaining nine characters of the NTFS partition, all types of users have all permission on it. This shows that the Linux system manages the permissions differently on the different types of file systems. If you see NTFS permissions here, everyone is allowed to do everything on the NTFS file system. It is normal because NTFS security doesn’t work in the same way as ext4 works. Linux can’t enforce its rules on the NTFS file system. If you want granular access controls, NTFS may not be the right choice for you. We recommend creating public directories and assigning permissions to them rather than managing the permissions at the level of the partition.

An image shows creating public directory for ext4 and ntfs filesystems
Creating a public directory for ext4 and NTFS filesystems
List the files under data-ext4 directory
List the files under the data-ext4 directory

You can manipulate the permission by using ‘chmod‘ command. To grant the missing write permissions on the ext4 public directory, type the following command.

$ sudo chmod go+w data-ext4/public

Here ‘go’ stands for Group and Other users, ‘+’ represents adding permissions, ‘w’ stands for Write permission. Please refer to the chmod and chown commands for more information https://www.computerhope.com/unix/uchmod.htm

Assigning the write permission to the ext4 public directory
Assigning the write permission to the ext4 public directory

How To Configure Samba To Share Directories On Raspberry Pi?

How to configure Samba on Raspberry Pi?

  1. $ sudo nano /etc/samba/smb.conf

Let’s back to our original topic. Share the public directories created on both partitions by configuring smb.conf file. Open the file using your choice of text editor. We are using nano text editor for demonstration purposes.

Editing smb.conf using nano on Raspberry Pi
Editing smb.conf using nano on Raspberry Pi

2. A small Note from smb.conf:

The workgroup setting is important when you want to access shared files from a Windows machine. Change the correct workgroup under the global settings if your windows workgroup is different than the default. Or, leave it as default.

Editing smb.conf using nano on Raspberry Pi
Editing smb.conf using nano on Raspberry Pi

3. Add min protocol = SMB2. This is because smbv2 has been around for a long time and older versions of windows still support v2 protocol.

Set SMB2 and WORKGROUM settings in the configuration file
Set SMB2 and WORKGROUM settings in the configuration file

4. Create file shares in SMB config file.

  1. [public-ntfs]
    path = /mnt/data-ntfs/public
    public = yes
    writeable = yes
Creating file shares in SMB config file
Create file shares in SMB config file

That’s it. Your Samba service should pick up the changes on its own, and sharing should be running already. Try rebooting the service if it didn’t.

Few tips:

Do this if you see any problem.

  1. Update the OS and its registry: $ sudo apt update && apt upgrade
  2. Install these packages, which help in working with multiple file systems: $ sudo apt install exfat-utils exfat-fuse ntfs-3g
  3. You can secure your sharing by adding a user account to smb.conf file. To add a user account, open the file /etc/samba/smb.conf in any text editor and add the ‘valid user = user1’ line.
  4. If you can’t connect your Pi with its name, try this. Add ‘wins support = yes‘ under the global settings. “This is optional.”
The global settings of smb.conf file
Global settings of smb.conf file

This is how you can build a personal cross-platform file server on Raspberry Pi.

This post is originally published at thesecmaster.com.

We thank everybody who has been supporting our work and request you check out thesecmaster.com for more such articles.

--

--

TheSecMaster
TheSecMaster

Published in TheSecMaster

This is a place where we cover topics related to Cyber Security, Risk and Vulnerabilities, Malware, Digital forensics, Dark Web, Cyber Attacks, and Best practices. We also try covering various platforms like Cloud, Virtualization, Containers, and Operating System platforms.