Installation Instructions

AMPL Installation Wizard

Here are instructions to install AMPL-Gurobi on macOS:

  1. Extract the contents of the supplied AMPL-Gurobi file. Extraction is done with the following command:
    tar xvfz amplgurobi9.1.1_mac64.tar.gz
    The file name should be adjusted to reflect the actual archive file. Extraction will produce a subdirectory called ampl, which contains the AMPL-Gurobi software.
  2. Choose a destination directory. We recommend /usr/local/bin, but other directories will work as well. Copy the extracted files inside the ampl subdirectory to the destination directory.
  3. To allow the AMPL-Gurobi executable files to be found when needed, ensure that the PATH environment variable includes the AMPL installation directory. Assuming that AMPL is installed in /usr/local/bin, users of the bash shell would add the following to their .bashrc files:
    export PATH="${PATH}:/usr/local/bin"
    export LD_LIBRARY_PATH="${LD_LIBRARY_PATH}:/usr/local/bin"
    And users of the csh shell would add the following to their .cshrc files:
    setenv PATH ${PATH}:/usr/local/bin
    setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:/usr/local/bin
    If LD_LIBRARY_PATH is not already set, you would use the following instead:
    export LD_LIBRARY_PATH="/usr/local/bin"
    setenv LD_LIBRARY_PATH /usr/local/bin
    Note that you do not need to update LD_LIBRARY_PATH if you previously installed the standalone Gurobi Optimizer and set LD_LIBRARY_PATH during that process.
  4. You will need a license key for AMPL - even if you already have a license key for the standalone Gurobi Optimizer. To get system information needed for a license key, open a terminal prompt and type the command:
    fingerprint -o fp.out
    This will generate a fingerprint file named fp.out. To request your license key (after we have received your payment or a Gurobi sales representative has approved your request to evaluate AMPL), email the fp.out file to
  5. When you receive your license key, simply copy the license key file to the installation directory or any other directory in your PATH.
  6. If you are configuring a floating license server for AMPL-Gurobi, please follow the additional instructions for ampl_lic.