Installing Gaffer

The Gaffer package is a self-contained directory, so you will need to manually install it, and later manually configure it, if necessary. Once extracted, the Gaffer directory contains the complete application, ready for use.


In keeping with Linux/macOS best practices, we will demonstrate how to install Gaffer in the /opt/ directory. We also use C:\software\ on Windows as an example installation path. However, you could install it to any location on your file system to which you have write and execute access.

Installing in Linux

To install Gaffer in Linux:

  1. Download the latest Linux package of Gaffer.

  2. Open a terminal.

  3. Extract the archive:

    user@desktop ~ $ cd ~/Downloads
    user@desktop ~/Downloads $ sudo tar -xzf gaffer- -C /opt/

Gaffer is now installed to /opt/gaffer-

Installing in Windows

To install Gaffer in Windows:

  1. Download the latest Windows package of Gaffer.

  2. Extract the archive (for best performance, we suggest extracting with 7-Zip).

  3. Move the extracted gaffer- folder to the location you wish to install it under, such as C:\software.

Gaffer is now installed to C:\software\gaffer-


Gaffer requires the Microsoft Visual C++ Redistributable to be installed on Windows. This needs to be downloaded and installed before Gaffer can be launched.

Installing in macOS


Pre-built versions of Gaffer are currently unavailable on macOS.

To install Gaffer in macOS:

  1. Download the latest macOS package of Gaffer.

  2. Open the terminal (Finder > Go > Utilities > Terminal).

  3. Extract the archive:

    MacBook:~ user$ cd ~/Downloads
    MacBook:~/Downloads user$ tar -xzf gaffer- -C /opt/

Gaffer is now installed to /opt/gaffer-

See also