Netatalk is a Free and Open Source file server that implements the Apple Filing Protocol (AFP) 3.4 over TCP/IP. AFP is the primary file sharing protocol used on Apple II, Classic Mac OS, and Mac OS X, as well as one of several supported protocols on macOS. A *NIX/*BSD system running Netatalk provides high-speed AppleShare file sharing for macOS and Classic Mac OS clients.
If you need Netatalk to provide AFP over AppleTalk (DDP) in order to do file sharing with very old Macs or Apple II computers, please install the latest old stable Netatalk 2.x version. AppleTalk support was removed in Netatalk 3.0, however 2.x is still being actively maintained.
Find the latest Netatalk 2.x releases at netatalk.io or in the GitHub Releases section.
Netatalk developers and users hang out in online communal spaces like TinkerDifferent or 68kmla. You can head over there if you want to ask for help or share your experiences.
There is also an official Netatalk Discussions board on GitHub which is the best place to ask for technical assistance.
Finally, the traditional place where Netatalk developers and users interact with each other are the netatalk-admins and netatalk-devel mailing lists. While these lists aren't as active as they used to be, the archives are a veritable treasure trove of decades of Mac networking know-how.
If you have a local network of Macs - macOS, Mac OS X, and all the way back to Classic Mac OS - running a Netatalk AppleShare server allows you to share, collaborate on, and back up files comfortably. The latest macOS at the time of writing (macOS 14 Sonoma) ships with an AFP client, so Netatalk can act as a seamless bridge between new and old Macs.
Compared to cross-platform file sharing protocols NFS and FTP, Netatalk delivers full integration of Classic Mac OS metadata (resource forks) and macOS services such as Bonjour, Time Machine, and Spotlight.
Compared to Samba, Netatalk has demonstrably faster transfer speeds, as well as stronger backwards compatibility with OS X 10.8 Mountain Lion and earlier.
See INSTALL.md
See DOCKER.md
An administrative GUI webapp in the form of a first-party module for Webmin can be found in a sister repository
See the README in that repo for instructions how to install and get started with the module.
An overview of the module's feature set can be found in the wiki.
Bug reports and feature requests should be filed as GitHub issue tickets.
Before contributing code to the project, please read the coding guidelines in the wiki on how to prepare a PR that is likely to be accepted by the maintainers.
PRs are automatically picked up by GitHub CI, which runs the builds, integration tests, as well as static analysis scan on SonarCloud.
To aid in your installation and configuration of Netatalk, a comprehensive html manual is published online.
Additionally, each Netatalk program and configuration file also has a troff man page which can be accessed on the command line, f.e. man afpd
.
Collaborative articles can be found on the Netatalk wiki hosted on GitHub.
Editing is open to all registered GitHub users. We welcome improvements to existing material, as well as brand new articles on topics concerning Netatalk or Mac networking in general.
The Netatalk website netatalk.io is where project updates and resources are published, including documentation, release notes, security advisories, links to related projects, and more.