Adding Watchfolders to Console

A watchfolder automates file transfers from a source to a destination system. Files are placed into a source folder and automatically transferred to the destination. It runs from the client side only and does not require any additional software on the destination system.

To configure a watchfolder, first add the source host to Console as a managed node using the Node API credentials created for the watchfolder user (see Setting Up Watchfolders). For more information about configuring managed nodes, see the "Adding Nodes to Console" section in the IBM Aspera Console Admin Guide.

Follow the instructions below to create a new watchfolder.

  1. Log into Console at https://console_host_address.
  2. Go to Configuration > Console Defaults and select Enable Watchfolder management from Console. You must enable this option to access the Watchfolders tab on the Activity Overview page.
  3. Go to Activity > Watchfolders and click Create New Watchfolder.
  4. Name your watchfolder.
  5. Select a managed node from the drop-down menu.
    Note: Only nodes configured to run watchfolders appear on the drop-down list. If you do not see any nodes, make sure your nodes are properly configured.



  1. Click Browse to choose the source directory or enter the source path.
    Tip: The source folder is relative to associated system user's docroot. In this case, the system user is "root". For example, if you enter the path project1/final and the docroot for "root" is /root, the full path is /root/project1/final. You can change the docroot by going to Nodes > edit > Configuration > Docroot in Console.
    Alternatively, you can run the following asconfigurator command on the source node to change the docroot:
    # /opt/aspera/bin/asnodeadmin.exe asconfigurator -x "set_user_data;user_name,root;absolute,/docroot_dir"
  2. Enter the host address of the remote node.
  3. Enter the SSH login credentials for the remote host.

    Enter the administrative account username and password to allow Console to connect to the node machine. Authenticate the account with either a password or a saved SSH key.

    • Password authentication: Enter the account password.
    • Public key authentication: Select Use SSH Key and select your uploaded key. To use public key authentication, you must have your SSH private key configured in Console. For instructions, on how to configure SSH keys in Console, see SSH Keys.
  4. Set the TCP and UDP ports. By default, TCP uses port 22 and UDP uses port 33001.
  5. Click Browse to test the connection and choose the target directory.



  1. Optional: Configure additional watchfolder settings. For more information on watchfolder settings, see Watchfolder Options.

  2. Click Create.