Free US Shipping on orders over $150 with discount code "FREESHIP" at checkout

Using Netatalk to share files between a Raspberry Pi and Mac

December 12, 2019 2 Comments

Using Netatalk to share files between a Raspberry Pi and Mac

We love using Raspberry Pi's to do all sorts of things around the office, but it can be a bit of a pain accessing the files on the Pi from our Apple Macintosh computers.  

We have always used Netatalk to allow file sharing, but it seemed to break with the latest version of Raspbian Buster.

Fortunately, we figured how how to fix this problem today!  

First, you will want to install Netatalk on your Pi.  The following commands update Raspbian's package information and then downloads the latest version of Netatalk

sudo apt-get update
sudo apt-get install netatalk


It used to be that these two commands were enough to get Netatalk working.  You'd simply go into your Mac's finder, click "Network", see your Raspberry Pi, and hit Connect.  With Buster, this stopped working.  In our log files, we could see the Mac trying to connect, but then the Mac would throw an error.

Netatalk 3.x is generally controlled by a file called /etc/netatalk/afp.conf

If you are using a version Netatalk prior to 3.0, the below configuration file changes should not be necessary.  You can see which version you have by typing "apt-cache policy netatalk"

If you take a look at the default install of that file, you will see something like this:

; Netatalk 3.x configuration file
; Global server settings
; [Homes]
; basedir regex = /home
; [My AFP Volume]
; path = /home/pi
; [My Time Machine Volume]
; path = /path/to/backup
; time machine = yes
; log file = /home/pi/afp.log
Those semi colons indicate almost every line in the above file are commented out.  So, by default, nothing in shared in Netatalk.  From a security standpoint this is nice, but from a usability standpoint it seems a bit overkill.
To allow Netatalk to connect to /home/pi, all you have to do is uncomment two lines:
basedir regex = /home
And then restart Netatalk with:
sudo systemctl restart netatalk
With any luck, when you go to Network in your Mac's Finder, you will see your Pi and you can connect to it.  Don't forget to change the username to pi (or whatever username you use on your Pi).  In the example below, we are connecting to a Pi called "matrixpi"

2 Responses


April 17, 2020

Thank sooo much for this post ! You made my day !

Jim Sutton
Jim Sutton

March 04, 2020

Really helpful post. I would not have been able to get afp working without this tip. I really appreciate the time you spent to write it up so cleanly..


Leave a comment

Comments will be approved before showing up.

Also in News

Ways To Use Raspberry Pi in the Classroom
Ways To Use Raspberry Pi in the Classroom

September 21, 2020

Raspberry Pi computers are useful for teaching students about computers and electronics. Discover ways to use Raspberry Pi in the classroom here.

Continue Reading

How a Micro:Bit Works: Getting Started
How a Micro:Bit Works: Getting Started

September 02, 2020

A Micro:Bit is a small computer board that you can code and connect to other parts to create electronics. Here are the basics of how a Micro:Bit works.

Continue Reading

How To Build a Robot Using Raspberry Pi
How To Build a Robot Using Raspberry Pi

August 28, 2020

Many people would like to make robots but don’t know where to start. In this guide, we go over how to build a robot using a Raspberry Pi so you can get started.

Continue Reading