This article covers how to transfer and access remote files on a Raspberry Pi using Samba.
Step 1. Get to the command line
Remote login to the Raspberry Pi over ssh or open up a terminal window via the desktop.
Step 2. Get the latest updates
Get the latest updates by running this command:
$ sudo apt-get update
Step 3. Install Samba
Run this command to install Samba:
$ sudo apt-get install samba samba-common-bin
You may get prompted with a dialog box that asks:
Modify smb.conf to use WINS settings from DHCP?
Check the service status
Check the status of the service to confirm that it was installed and is working:
$ sudo /etc/init.d/smbd status
Look for lines like this to confirm that things are working:
Active: active (running) since (DATE); 3min 21s ago Status: "smbd: ready to serve connections..."
Step 4. Configure Samba for read and write access
To configure Samba for read and write access, open up its configuration file using the nano text editor:
$ sudo nano /etc/samba/smb.conf
Find the line that says read only and set it equal to no.
Step 5. Create a Samba password
Create a Samba password for remote access as user pi:
$ sudo smbpasswd -a pi
Step 6. Restart the Samba server
Restart the Samba server using this command:
$ sudo /etc/init.d/smbd restart
Check the status to confirm that there wasn’t an issue with the config file:
$ sudo /etc/init.d/smbd status
Step 7. Create a test file
Create a test file on your Raspberry Pi:
$ echo "This is a test." >> ~/test.txt
Confirm that the file was created:
$ cat ~/test.txt
Once a remote connection is setup, you can look for this file to verify that you have access.
Step 8. Connect to the Pi via Finder (Mac)
First I’m going to show you how to connect to the remote Pi on a Mac using Finder.
Later I will show you how to connect using the command line.
- Launch Finder
- Select from the main menu Go / Connect to Server
- Enter this address (substituting pi4 for for your pi hostname):
- Click Connect
- When prompted, remember to enter your Pi username (i.e. pi) and the Samba share password
- For volume selection, you may have only one option (pi)
- Click OK
The new volume should now appear in Finder where you can see the test file.
You should now be able to access and transfer files to and from the Pi from your Mac.
You can do that either through Finder or from the command line.
Step 9. Access the volume from the command line
In this step I’m going to show you some of the ways that you can access the remote volume using the command line.
List the volumes
When you connect using Finder, by default it adds the mount point to the /Volumes folder.
You can see the new mount point using the ls command:
$ ls /Volumes/ Macintosh HD pi
In the example above, the pi volume is listed.
List all mount points
You can list all of the mount points on your Mac using the df command:
The mount point for the Pi will probably be the last (newest) entry in the result:
Filesystem 512-blocks Used Available Capacity iused ifree %iused Mounted on ... //email@example.com/pi 122233368 7864672 114368696 7% 3932334 57184348 6% /Volumes/pi
List the files on the remote volume
To list the files on the remote (pi) volume, use this command:
$ ls /Volumes/pi
You should see the test file that you created on the Pi:
Read a file on the remote volume
Verify that you can read the test file contents using the cat command:
$ cat /Volumes/pi/test.txt
Create a file on the remote volume
Verify that you can create a new file on the remote volume and write to it:
$ echo "This is another test." >> /Volumes/pi/test2.txt $ cat /Volumes/pi/test2.txt
The result should be the line that you just echoed to the new file.
Copy a file from the remote volume
Verify that you can copy files from the remote volume using the cp command:
$ cp /Volumes/pi/test.txt ~/mytest.txt $ cat ~/mytest.txt
Unmount the remote volume folder
To disconnect from a remote volume, use the umount command.
Connect via the command line
To connect via the command line you need to do the following:
- Verify that no other folder is currently mounted to the remote Pi (or you will get an error)
- Make a new folder
- Mount the remote Pi to the folder using the mount_smbfs command
- List the contents of the new folder to verify that you have access
Here is an example of mounting a remote Pi to a folder called mypi on a Mac.
Substitute YOUR-HOSTNAME in the command below with your Pi hostname.
Substitute YOUR-PASSWORD with the Samba password defined in a previous step:
$ mkdir ~/mypi $ mount_smbfs //pi:YOUR-PASSWORD@YOUR-HOSTNAME.local/pi ~/mypi $ ls -ls mypi
To test it, create another file using echo and dump its contents to the console using cat:
$ echo "Yet another test." >> ~/mypi/test3.txt $ cat ~/mypi/test3.txt
Confirm on the pi that all three test files have been created:
ls -ls ~
Unable to connect
If you can’t connect, make sure that your laptop and pi are on the same network.
File exists error
What does it mean if mount_smbfs returns a File exists error like this?
mount_smbfs: mount error: /Users/mitch/pi2: File exists
What this confusing error actually means is that the remote folder has already been mounted.
You can’t mount the same folder in two locations.
No such file or directory error
What does it mean if mount_smbfs returns a No such file or directory error like this?
mount_smbfs: could not find mount point /Users/mitch/pi2: No such file or directory
That means that you need to create the folder (in this case /Users/mitch/pi2) before you can mount the remote Pi to it.
In this article you learned how to:
- Install Samba on a Raspberry Pi
- Mount a Raspberry Pi remote volume and folder
- Access files on a remote Pi using Finder
- Access files on a remote Pi using the command line
- Headless Raspberry Pi 4 SSH WiFi Setup (Mac + Windows)
- How to Cross Compile for Raspberry Pi Using Docker
- samba.org 
About the Author
Mitch Allen works for a robotics company in New England.