The following instructions will set your RPi to share its files on your local network and be accessible by Windows.

This is based on the great guide here.

Install Samba

sudo apt-get install samba samba-common-bin

Samba contains the SMB protocol, support for the Windows naming service (WINS), and support for joining Windows workgroups. Samba-common-bin contains a tool that you'll need to register users with Samba.

Configure Samba

sudo nano /etc/samba/smb.conf

Search for the workgroup line (normally at the top) and if necessary set it to match your workgroup (if you don't need it set then it can just be left as default, works fine for us not changed)

Below it you'll find the wins support line, if there is a # at the start of the line remove it to stop it being commented out and then ensure it is set to "yes", so you should have:

workgroup = your_workgroup_name
wins support = yes

Add a section at the bottom which contains the settings for the share:

   comment= Pi Home
   only guest=no
   create mask=0777
   directory mask=0777


Change path as required ( "path=/" is fine if you want access to the entire drive).

If you want to permit read only access change writeable to "No"

Use CTRL+X to save and exit.

Finally add the pi user by typing this command and entering the pi's password twice:

sudo smbpasswd -a pi

That's it.  If you select "Network" in windows explorer device "RASPBERRYPI" should be found (it may take a minute or two to appear).  In it the "pihome" folder will be the folder you've shared.

Restarting Samba

sudo /etc/init.d/samba restart




We benefit hugely from resources on the web so we decided we should try and give back some of our knowledge and resources to the community by opening up many of our company’s internal notes and libraries through mini sites like this. We hope you find the site helpful.
Please feel free to comment if you can add help to this page or point out issues and solutions you have found, but please note that we do not provide support on this site. If you need help with a problem please use one of the many online forums.


  1. SeanBearden

    10 years ago

    Just to let anyone know who is curious, I followed the above set up and it works for my Mac, also. I am running OS X Yosemite.


Your email address will not be published. Required fields are marked *