ansible-role-netatalk

Ansible role to install and configure Netatalk, an Apple Filling Protocol (AFP), server. This allows Linux folders to be shared natively to Mac OSX machines.

Combined with Avahi a Linux server can appear as a native Apple fileserver to Mac OSX machines on the same network.

Requirements

This role has been tested on Ubuntu 16.04 and should work on most modern Debian installations.

The role will need sudo privileges so it should be run with become: True or a user with sufficient default privileges to install and configure packages.

Role Variables

The following variables are defined in defaults/main.yml and can be used to further configure Netatalk shares. netatalk_shares is the most important variable which defines which services are advertised 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'

See afpd.conf and AppleVolumes.default for more detailed documentation on configuring shares and afpd options.

Dependencies

None, however Avahi is highly recommended.

Example Playbook

Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:

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

License

MIT

Author Information

Created with love by Brian Hartsock.