How to Host Connect 3.x plugins and installers on Faspex


You may want to host your own IBM Aspera Connect installers and plugins for your applications rather than having the downloads served from Aspera's CloudFront CDN. To host your own copies of the latest installers and Connect browser plugin on your IBM Aspera Faspex Server, use the following instructions.


These instructions require at minimum Faspex version 3.9.1.

If you are on Faspex 3.9.1, your Faspex server must also be patched for Connect 3.6 in order to serve installations of this version. For instructions on how to patch Faspex for Connect 3.6, see


1. Download the latest Connect SDK 3.x from the Aspera Developer Network and unzip the folder into a temporary location.

2. Create a folder named connect in the following location, based on your system:

  • Linux: /opt/aspera/faspex/connect
  • Windows (64 bit): C:\Program Files (x86)\Aspera\Faspex\connect
  • Windows (32 bit): C:\Program Files\Aspera\Faspex\connect

For example, you could do this with the following command:

On Linux
mkdir /opt/aspera/faspex/connect

On Windows
mkdir "C:\Program Files (x86)\Aspera\Faspex\connect"

3. Copy the contents of the Connect SDK to your new connect folder.

You could do this with the following command, using your path to the Connect SDK folder:

On Linux
cp -r /path/to/ConnectServerSDK/. /opt/aspera/faspex/connect

On Windows
xcopy /E C:\path\to\ConnectServerSDK\. "C:\Program Files(x86)\Aspera\Faspex\connect"

4. Open the connectinstaller-4.js file which should now be found at the following:

  • Linux: /opt/aspera/faspex/connect/v4/connectinstaller-4.js
  • Windows: C:\Program Files (x86)\Aspera\Faspex\connect\v4\connectinstaller-4.js

Find the variable updatesURL, and ensure it is set to connectOptions.sdkLocation, as below:

var updatesURL = connectOptions.sdkLocation;

If it is not, set it as above. Older versions of the SDK (prior to 3.6.6) would require this change.

Save the file.

5. Edit your Faspex Apache configuration file to add the proper URL redirect for the connect folder.

On Linux, the file is located at:

  • /opt/aspera/faspex/config/faspex.apache.template.conf

Add the following section to the end of the file:

Alias /connect "/opt/aspera/faspex/connect" 
<Directory "/opt/aspera/faspex/connect"> 
   Options -Indexes -FollowSymLinks 
   AllowOverride none 
   Order allow,deny 
   Allow from all 

On Windows, the file is located at:

  • 64 bit: C:\Program Files (x86)\Aspera\Faspex\config\faspex.apache.template.conf
  • 32 bit: C:\Program Files\Aspera\Faspex\config\faspex.apache.template.conf

Add the following section to the end of the file:

Alias /connect "C:/Program Files (x86)/Aspera/Faspex/connect" 
<Directory "C:/Program Files (x86)/Aspera/Faspex/connect"> 
   Options -Indexes -FollowSymLinks 
   AllowOverride none 
   Order allow,deny 
   Allow from all 

Save and exit the file. Then, run the following command:

asctl faspex:generate_config

6. For Linux Only: Give the faspex user ownership over the connect folder, and give the folder proper permissions.

You can do this with the following commands:

chown -R faspex:faspex /opt/aspera/faspex/connect
chmod -R 755 /opt/aspera/faspex/connect

7. Edit your connect_auto_install.js file.

The file may be found in the following locations based on your system:

  • Linux: /opt/aspera/faspex/public/javascripts/connect_auto_install.js
  • Windows (64 bit): C:\Program Files (x86)\Aspera\Faspex\public\javascripts\connect_auto_install.js
  • Windows (32 bit): C:\Program Files\Aspera\Faspex\public\javascripts\connect_auto_install.js   

Open the file in a text editor and find the following lines:

var AW2_URL = '//';
var AW4_URL = '//';

Replace with the lines below. This will cause the Connect installers and plugins to come from your own server rather than from Aspera:

var AW2_URL = '//''/connect';
var AW4_URL = '//' +'/connect/v4';

Next, find the following line:

loadJS(AW4_URL + '/connectinstaller-4.min.js', function() {

and replace it with the line below:

loadJS(AW4_URL + '/connectinstaller-4.js', function() {

Save the file.

8. Restart the Faspex Apache service. From a command line, run the following:

asctl apache:restart

9. Your Faspex server is now hosting Connect 3.6 plugins and installers.

Powered by Zendesk