Installing FreeFlyer

Installation on Windows

FreeFlyer for Windows is a 64-bit application. Once installed, both the standalone integrated development environment version (FreeFlyer-8.exe) and the headless version (ff-cli.exe) are available for use.

  • FreeFlyer_X.X.X.X_Installer.msi

    • This installer installs FreeFlyer onto the system.

    • This installer is capable of silent installation/uninstallation

How to Install

  1. After obtaining the FreeFlyer installer from a.i. solutions, run the installer by double-clicking the appropriate installer file. At the welcome page of the installer, click Next.

 

 

  1. At the License Agreement page, review the license agreement, select the acceptance radio button, and click Next.

 

 

  1. At the Choose Destination Location page, either accept the default FreeFlyer installation directory or specify another directory and click Next.

 

 

  1. At the Ready to Install page, if desired go back to review the installation settings. When ready click Install to begin the installation. Note that administrator approval will be requested at this point.

 

 

  1. At the installation completion page, select whether you would like to launch FreeFlyer immediately, then click Finish to exit the Setup Wizard.

 

 

This completes the installation process. For information on how to register your FreeFlyer installation see the Node-Locked Licensing or Network Licensing guides.

 

NOTE: msiexec can be used with the MSI installer of FreeFlyer to automate installation across multiple machines. A particularly helpful application for this is to use a call to msiexec within a batch file in combination with the --activate-license command line switch to both install and license FreeFlyer together.

 

 

Installation on Linux

FreeFlyer is available for 64-Bit Red Hat Enterprise Linux 8 and Red Hat Enterprise Linux 9. Once installed, both the standalone integrated development environment version (FreeFlyer-8.exe) and the headless version (ff-cli.exe) are available for use. Once you've acquired the Linux FreeFlyer install package from a.i. solutions, perform the following steps to complete the installation. Root privileges are required in order to complete the installation process.

 

How to Install

  1. Open a terminal window.

 

 

  1. Navigate to the directory that contains the FreeFlyer install package.

  1. Enter the following commands into the terminal, making sure to update the RPM filename to that of the RPM you are installing.

 

 

You could also auto-accept the software license agreement during this step by setting the FF_ACCEPT_SLA environment variable equal to true during the installation. This is particularly useful for automated installations.

 

  1. When prompted, enter your administrative password, review the license agreement and use "y" to accept, and use "y" to confirm that you want to unpack the FreeFlyer package.

 

This completes the installation process. You can confirm that the installation was completed successfully by using the version command line switch for the headless interface:

 

 

If FreeFlyer was installed correctly, this will report the FreeFlyer version to the terminal. To verify the Integrated Development Environment (IDE) is functional, you can launch the graphical interface from the terminal:

 

 

NOTE: For a full listing of available command line switches use the help switch (-h).

 

This completes the installation process. For information on how to register your FreeFlyer installation see the Node-Locked Licensing or Network Licensing guides.

 

How to Uninstall

  1. Open a terminal/shell window.

  2. Enter the following commands into the terminal, making sure to update the FreeFlyer version. This example was generated for FreeFlyer 8.0.0.XXXXXXXX.

 

 

  1. When prompted, enter your administrative password and use "y" to confirm that you want to remove the specified FreeFlyer install.

 

This completes the removal process. You can confirm that FreeFlyer was uninstalled successfully by navigating to the FreeFlyer folder in the share directory (/usr/share/a.i. solutions, Inc/<FREEFLYER VERSION>/) and verifying that the executables (ff-cli.exe and FreeFlyer-8.exe) are no longer present.

 

 

Installation on macOS (Beta)

FreeFlyer for macOS is designed exclusively for 64-bit Apple silicon hardware. Intel-based Mac hardware platforms are not supported. Once you have acquired the macOS FreeFlyer installation package from a.i. solutions, perform the following steps to complete the installation.

 

How to Install

  1. Double click the .dmg installation file.

  2. In the window that opens, drag the FreeFlyer application into the Applications folder.

  3. Navigate to the Applications folder and confirm that FreeFlyer-8.app is present.

     

You can launch FreeFlyer from the Applications folder or from a terminal using the following command:

 

 

This completes the installation process. For information on how to register your FreeFlyer installation see the Node-Locked Licensing or Network Licensing guides.

 

See Also

Licensing Options ›