Server-Side Symbolic Link Handling

The following section describes how Aspera handle symbolic links in Aspera Sync based on settings configured in the aspera.conf file. The aspera.conf is located in the following location:

/Library/Aspera/etc/aspera.conf

Configuration Options

The following configuration options are set using the <file_system> section in the aspera.conf file:

  <file_system>
    <symbolic_links>LIST OF COMMA SEPARATED OPTIONS</symbolic_links>
  </file_system>

Note: If no option is specified, the configuration will default to "create, follow."

Option	Description	Client Behavior	Server Behavior
create	Create symbolic links with arbitrary targets. This is option set by default.	Disallowed if not configured. Note: Servers running on a Windows platform will always reject such a request, regardless of the option configured.	Symbolic links are always copied to the server if the client requests.
follow	Follow symbolic links with targets inside docroot. If at any point the path goes outside the docroot, Aspera Sync will not complete the transfer. This is option set by default.	Symbolic links are always copied to the server if the client requests. Note: If the docroot is a symbolic link and is specified as the source or destination: As the receiver, follow the target widely (no docroot constraint) and unconditionally (regardless of symbolic link action(s) configured/requested).
follow_wide	Follow symbolic links with arbitrary targets, even if the targets are outside the docroot.	Disallowed if not configured, except for Windows servers. Follow symbolic links anywhere without docroot constraint. Note: If the docroot is a symbolic link and is specified as the source or destination: As sender, follow the target unconditionally (regardless of symbolic link action(s) configured/requested).
none	Take no action with the symbolic link.