{"id":133,"date":"2023-12-19T09:52:32","date_gmt":"2023-12-19T09:52:32","guid":{"rendered":"http:\/\/192.168.8.136\/wordpress\/?p=133"},"modified":"2024-01-09T15:51:25","modified_gmt":"2024-01-09T15:51:25","slug":"rpi-nas-part-9-mounting-shares-on-various-systems","status":"publish","type":"post","link":"https:\/\/mpr-projects.com\/index.php\/2023\/12\/19\/rpi-nas-part-9-mounting-shares-on-various-systems\/","title":{"rendered":"RPi NAS: Part 9 Mounting Shares on Various Systems"},"content":{"rendered":"\n

In the video in the previous post we installed Greyhole on our Raspberry Pi. We also set up a simple Samba share. In this post we’re going to mount Samba shares on a few different operating systems.<\/p>\n\n\n

This post is part of a series about building a Network-Attached Storage (NAS) with redundancy using a Raspberry Pi (RPi). See here<\/a> for a list of all posts in this series.<\/p>\n\n\n\n

\n\n\n\n

Mounting Samba shares is not difficult and there are lots of resources available online. So this post is mostly for completeness1<\/a><\/sup> and so you don’t have to look elsewhere if you’ve been following this series of posts.<\/p>\n\n\n\n

I’m assuming that you’re interested in mounting the shares on your main OS. So if you’re a Windows user then you’ll probably skip the Linux and macOS sections2<\/a><\/sup>. Thus each of the three section below (Linux, macOS and Windows) is written independently of the others. So if you read them all then you may find them a bit repetitive.<\/p>\n\n\n\n

Linux<\/h2>\n\n\n\n

Let’s start with Linux. We’ll first look at mounting shares via the command line, which should be quite consistent across different flavours of Linux. <\/p>\n\n\n\n

Command Line<\/h3>\n\n\n\n

I’m going to assume that we know the IP-address of the Raspberry Pi, but we may have forgotten the exact names of the Samba shares (that happens to me sometimes). To find out which shares are available on a server we can use smbclient<\/em>. You may have to install it first3<\/a><\/sup>, then run command<\/p>\n\n\n\n

smbclient -L rpi-ip-address -U%<\/code><\/pre>\n\n\n\n
This should give an output similar to the picture below.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
To mount a share we first have to create a mount point, for example mkdir \/home\/mpr\/temp_mount<\/em>. To mount shares we use cifs<\/em>. You may have to install cifs-utils<\/em> first4<\/a><\/sup>. For example, let’s mount share Photography<\/em> to temp_mount<\/em>:<\/p>\n\n\n\n
sudo mount -t cifs \/\/192.168.50.210\/Photography \/home\/mpr\/temp_mount -o uid=mpr,user=mpr<\/code><\/pre>\n\n\n\n
Option user<\/em> (or username<\/em>) is the name of your Samba user on the Raspberry Pi. Option uid<\/em> refers to the user that owns the files in the mounted Samba shares5<\/a><\/sup>. Upon running the command we’ll be asked for the password of our Samba user on the Raspberry Pi. We could also enter the password directly in the command above with option password<\/em>.<\/p>\n\n\n\n
If we want to automatically mount the Samba shares when our system boots then we have to edit fstab<\/em>. So let’s open fstab<\/em> with sudo vim \/etc\/fstab<\/code> and add the following line for each Samba share<\/p>\n\n\n\n
\/\/rpi-ip-address\/ShareName \/path\/to\/mount\/point cifs credentials=\/path\/to\/credentials\/file,uid=username,gid=username 0 0<\/code><\/pre>\n\n\n\n
For example, it could look like this:<\/p>\n\n\n\n
\"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
The credentials file is a file that contains our username and password so we don’t have to put them into fstab<\/em> directly. For example<\/p>\n\n\n\n
username=mpr\npassword=123<\/code><\/pre>\n\n\n\n
Since we don’t want everybody to be able to read our username and password we should set strict permissions on that file, for example:<\/p>\n\n\n\n
chmod 600 \/home\/mpr\/rpi-nas\/.smbcredentials<\/code><\/pre>\n\n\n\n
You can also change the ownership of .smbcredentials<\/em> to root with sudo chown root:root \/home\/mpr\/rpi-nas\/.smbcredentials<\/code>. That may add some extra security.<\/p>\n\n\n\n
As always when editing fstab<\/em>, reload the daemon and check if everything is ok:<\/p>\n\n\n\n
sudo systemctl daemon-reload\nsudo findmnt --verify<\/code><\/pre>\n\n\n\n
The shares will now be auto-mounted on boot (if they are available). You can also run sudo mount -a<\/code> to manually mount all filesystems specified in fstab<\/em>.<\/p>\n\n\n\n
You may lose the connection to the Samba shares temporarily, for example when you disconnect from the network. Once you reconnect the connection will be restored and you’ll have access to the Samba shares again6<\/a><\/sup>.<\/p>\n\n\n\n
Graphical Option<\/h3>\n\n\n\n
Some Desktop Environments provide graphical options for connecting to Samba shares. As an example we’ll look at Gnome on Ubuntu. Open Files<\/em> (Nautilus) and click on Network<\/em>.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Our NAS is right there as RPI-NAS<\/em>. Double-click it and you’ll see the available shares.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Double-click a share to access it. You’ll be asked to log in with the credentials of your Samba user on the Raspberry Pi.<\/p>\n\n\n\n
\"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
<\/p>\n\n\n\n
Note, you will only be able to access a share if the permissions set on the Raspberry Pi permit it (we’ll look at that in more detail in the next post). <\/p>\n\n\n\n
Finally, what we’ve done in this section is not identical to the previous section. On the command line we mounted a share to a directory of our choosing. In this section the share gets mounted to the place determined by Desktop Environment. For most (all?) uses that I’ve got in mind for my NAS that’s perfectly fine7<\/a><\/sup>.<\/p>\n\n\n\n
macOS<\/h2>\n\n\n\n
Let’s have a look at macOS. First things first, I only have access to a 2013 MacBook Air which runs High Sierra. From what I’ve found online the commands below should still work on newer versions of macOS but I haven’t been able to test that.<\/p>\n\n\n\n
You don’t need to install any additional software to mount Samba shares on macOS. Let’s start with mounting shares from the command line.<\/p>\n\n\n\n
Command Line<\/h3>\n\n\n\n
I’m going to assume that we know the IP-address of the Raspberry Pi, but we may have forgotten the exact names of the Samba shares (that happens to me sometimes). First let’s open the Terminal<\/em>. To find out which shares are available on a server we can use smbutil<\/em>.<\/p>\n\n\n\n
smbutil view -g \/\/rpi-ip-address<\/code><\/pre>\n\n\n\n
This should give an output similar to the picture below.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
To mount a share we first have to create a mount point, for example mkdir \/Users\/mpr\/Photography<\/em>. To mount a share we run<\/p>\n\n\n\n
mount -t smbfs \/\/mpr@rpi-ip-address<\/code><\/pre>\n\n\n\n
Instead of mpr<\/em> use the name of your Samba user on the Raspberry Pi. Upon running the command we’ll be asked for the password of our Samba user on the Raspberry Pi. We could also enter the password directly in the command by replacing \/\/username@rpi-ip-address<\/em> with \/\/username:password@rpi-ip-address<\/em> .<\/p>\n\n\n\n
To automatically mount Samba shares on boot we can use launchd <\/em>8<\/a><\/sup>. We’re going to place the following script in \/Users\/mpr\/Library\/LaunchAgents<\/em>. You can give it any name you like, for example rpi_nas_photography.plist<\/em> (the ending has to be .plist<\/em>).<\/p>\n\n\n\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-\/\/Apple\/\/DTD PLIST 1.0\/\/EN\" \"http:\/\/www.apple.com\/DTDs\/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n    <dict>\n        <key>Label<\/key>\n        <string>nas_mounts<\/string>\n        <key>ProgramArguments<\/key>\n        <array>\n            <string>\/sbin\/mount<\/string>\n            <string>-t<\/string>\n            <string>smbfs<\/string>\n            <string>\/\/username:password@192.168.50.210\/Photography<\/string>\n            <string>\/Users\/mpr\/Documents\/Photography<\/string>\n        <\/array>\n        <key>RunAtLoad<\/key>\n        <true\/>\n    <\/dict>\n<\/plist><\/code><\/pre>\n\n\n\n
Replace username<\/em> and password<\/em> with the username and password of you Samba user on the Raspberry Pi (and replace the IP-address and paths with those appropriate for your system).<\/p>\n\n\n\n
I don’t know of the best way of auto-mounting Samba shares on boot without adding your password<\/em> directly into the script above. I’ve seen one description here<\/a> but that uses quite a different approach9<\/a><\/sup> (and it feels quite long). If you know of a way that integrates nicely with the code above then let me know and I’ll update this page.<\/p>\n\n\n\n
Graphical Option<\/h3>\n\n\n\n
If you don’t need to mount the Samba shares to a particular folder then you can just use the graphical user interface. Open Finder<\/em>. Under Shared<\/em> you will see the name of your NAS, here it’s RPI-NAS.<\/em> Click it to see the available shares.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
On the top right of the window click on Connect As…<\/em> and enter the username and password of your Samba user on the Raspberry Pi.<\/p>\n\n\n\n
\"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
You can save the password to keychain<\/em> if you like10<\/a><\/sup>. Note, you will only be able to access a share if the permissions set on the Raspberry Pi permit it (we’ll look at that in more detail in the next post). <\/p>\n\n\n\n
Finally, what we’ve done in this section is not identical to the previous section. On the command line we mounted a share to a directory of our choosing. In this section the share gets mounted to the place shown in Finder<\/em>. For most (all?) uses that I’ve got in mind for my NAS that’s perfectly fine7<\/a><\/sup>.<\/p>\n\n\n\n
Windows<\/h2>\n\n\n\n
Samba was originally created for Windows so it’s supported out-of-the-box. Since you’re a Windows user I’m assuming that you’re not so interested in using the command line so we’ll focus on the graphical method. It’s very easy to connect to the Samba shares on the Raspberry Pi. Below we’ll do it on Windows 1012<\/a><\/sup>.<\/p>\n\n\n\n
Open the File Explorer (e.g. by pressing the Windows key, typing Explorer<\/em> and pressing enter). In the address bar type \\\\rpi-ip-address<\/code> (note the double backslash). In my network the RPi has address 192.168.50.210 so it looks like:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
If the username and password of your Samba user on the RPi are identical to those of your Windows account then you’ll immediately see the available shares. Otherwise you’ll be asked to identify yourself.<\/p>\n\n\n\n
\"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
Enter your username and password. If you want Windows to automatically connect to Samba shares after booting up (or if you don’t want to enter your details after every boot), then you’ll have to select Remember my credentials<\/em>. Press OK<\/em>. Now you should see the Samba shares on the RPi.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
You can open a share and access data on it like you would on any local folder13<\/a><\/sup>. If you want your system to automatically connect to a share then<\/p>\n\n\n\n