From Freenas
Jump to: navigation, search

The Apple Filing Protocol (AFP) is a network protocol that offers file services for Mac computers. Before configuring this service, you should first create your Apple (AFP) Shares. After configuring this service, go to Services → Control Services to start the service. The AFP shares will not be available on the network if this service is not running.

Starting this service will open the following ports on the FreeNAS® system:

  • TCP 548 (afpd)
  • TCP 4799 (cnid_metadata)
  • UDP 5353 and a random UDP port (avahi)

Figure 8.2a shows the configuration options which are described in Table 8.2a.

Figure 8.2a: AFP Configuration


Table 8.2a: AFP Configuration Options

Setting Value Description
Guest Access checkbox if checked, clients will not be prompted to authenticate before accessing the AFP share
Guest Account drop-down menu select account to use for guest access; the selected account must have permissions to the volume/dataset being shared
Max. Connections integer maximum number of simultaneous connections
Enable home directories checkbox if checked, any user home directories located under Home directories will be available over the share
Home directories Browse button select the volume or dataset which contains user home directories

When configuring home directories, it is recommended to create a dataset to hold the home directories which contains a child dataset for each user. As an example, create a dataset named volume1/homedirs and browse to this dataset when configuring the “Home directories” field of the AFP service. Then, as you create each user, first create a child dataset for that user. For example, create a dataset named volume1/homedirs/user1. When you create the user1 user, browse to the volume1/homedirs/user1 dataset in the "Home Directory" field of the “Add New User” screen.


If you receive a "Something wrong with the volume's CNID DB" error message, run the following command from Shell, replacing the path to the problematic AFP share:

dbd -rf /path/to/share

This command may take a while, depending upon the size of the volume or dataset being shared. This command will wipe the CNID database and rebuild it from the CNIIDs stored in the AppleDouble files.

Personal tools