ansible-role-netatalk

This is an Ansible role used to install and set up Netatalk, which is a server for the Apple Filing Protocol (AFP). This allows Linux folders to be shared easily with Mac OSX computers.

When paired with Avahi, a Linux server can show up like a regular Apple fileserver to Mac OSX computers on the same network.

Requirements

This role has been tested on Ubuntu 16.04 and should work on most recent Debian versions.

It needs sudo permissions, so you should run it with become: True or as a user who has enough permissions to install and set up packages.

Role Variables

The variables you can adjust are listed in defaults/main.yml. The most important one is netatalk_shares, which specifies the services shared over mDNS.

netatalk_shares:
  - /srv/TimeMachine TimeMachine allow:user1,user2 volsizelimit:1048576 cnidscheme:dbd options:tm"
  - /srv/media Media allow:user1,user2 cnidscheme:dbd"
netatalk_afpd_options: '- -tcp -noddp -uamlist uams_randnum.so,uams_dhx.so,uams_dhx2.so -nosavepassword'

For more information about setting up shares and afpd options, check afpd.conf and AppleVolumes.default.

Dependencies

There are no required dependencies, but using Avahi is strongly recommended.

Example Playbook

It’s helpful to provide an example of how to use this role (like how to pass in variables) for users:

- hosts: servers
  roles:
     - name: brianhartsock.netatalk
       become: true

License

MIT

Author Information

Created with care by Brian Hartsock.