Installation Notes

Recommended packages

When compiling Netatalk from scratch, you will need to install a number of required and optional packages to get a fully functional installation.

This page is intended to serve as a companion to the Installation chapter (2.2) of the Netatalk manual. Distros come and go and package names change, so this kind of fluid documentation is more suited for a wiki.

Debian Linux

Mandatory packages.

$ apt install libssl-dev libdb-dev autotools-dev automake libtool libtool-bin pkg-config libevent-dev

For papd printer server support, install CUPS packages. (netatalk2 only)

$ apt install libcups2-dev cups

For Zeroconf (Bonjour) service discovery in Mac OS X 10.2 or later, install Avahi packages.

$ apt install libavahi-client-dev

For DHX2 authentication support, required for Mac OS X 10.2 or later, install libgcrypt.

$ apt install libgcrypt20-dev

To use the TCP wrapper install tcpd.

$ apt install tcpd

To enable afpstats support, install libdbus. (netatalk3 only)

$ apt install libdbus-1-dev libdbus-glib-1-dev

To enable Spotlight, install tracker and libdbus (above). (netatalk3 only)

$ apt install tracker libtracker-sparql-X.Y-dev

Red Hat

General usage notes for Red Hat derived distros.

For the asip-status script, Perl socket libraries are required.

$ dnf install perl-IO-Socket-IP perl-IO-Socket-INET6

With Netatalk 2 and AppleTalk networking, you may have to remove the blacklisting of the appletalk kernel module.

On Fedora 38, this is accomplished by deleting this file:

/etc/modprobe.d/appletalk-blacklist.conf

Fedora Server

$ dnf install openssl-devel libgcrypt-devel libdb-devel automake libtool avahi-devel cups-devel

### CentOS 9 Stream

$ dnf install openssl-devel libgcrypt-devel libdb-devel automake libtool avahi-libs libevent-devel krb5-devel

## Alpine Linux
### netatalk2
For bootstrap:

$ apk add libtool autoconf automake pkgconfig

For compilation:

$ apk add build-base gcc cups cups-dev

Berkeley DB:
As of [Alpine 3.13.0](https://wiki.alpinelinux.org/wiki/Release_Notes_for_Alpine_3.13.0), BDB is a deprecated package, so building BDB from code is required on Alpine. These are the rough steps:

1. Get the latest v5 tarball of BDB, e.g.: https://github.com/berkeleydb/libdb/releases/tag/v5.3.28
2. Extract the tarball
3. From the source root, cd to the `build_unix` dir
4. Run the `../dist/configure` script
5. Run `make` then `make install`
6. Configure netatalk with e.g.: `./configure --with-bdb=/usr/local/BerkeleyDB.5.3`

## OmniOSce
**Note:** These packages may apply also to other OpenSolaris / Illumos distros.

$ pkg install git libtool automake gcc7 bdb

To bootstrap:

$ pkg install pkg-config

## FreeBSD 13.1

To bootstrap:

$ pkg install pkgconf autoconf libtool automake

To build:

$ pkg install libgcrypt db5 libevent

With FreeBSD 13.1, due to a bug in netatalk bootstrap the linker flag must be manually set when configuring in order to find libevent. This will be fixed in the next version after 3.1.15.

$ LDFLAGS="-L/usr/local/lib" ./configure