Download and install the Optimization Solver SDK

Operating system

Language and compiler versions

Windows

Double-click the .msi installation file and follow the on-screen instructions.

To install for all users, run Command Prompt as an administrator, switch to the folder that contains the installer, and run the file from there.

Linux

Not sure which architecture you have? Run uname -m. The output x86_64 means use the x86 installer; aarch64 means use the ARM installer.

Run the following command and follow the prompts:

# x86_64 systems
bash mindopt-install-linux64x86-2.3.0.sh

# ARM (aarch64) systems
bash mindopt-install-linux64aarch-2.3.0.sh

# The admin user is used as an example.
RUN cd /home/admin/mindopt/ && \
    bash mindopt-install-linux64x86-2.3.0.sh --target /home/admin/mindopt && \
    rm -rf mindopt-install-linux64x86-2.3.0.sh

# Set the MindOpt environment variables.
ENV MINDOPT_HOME /home/admin/mindopt/2.3.0
ENV PATH $MINDOPT_HOME/linux64-x86/bin:$PATH
ENV LD_LIBRARY_PATH $MINDOPT_HOME/linux64-x86/lib:$LD_LIBRARY_PATH

# MDO_NATIVE_LIBRARY is required for the Java SDK in V0.x.x. Not needed for V1.0.0 or later.
ENV MDO_NATIVE_LIBRARY $MINDOPT_HOME/linux64-x86/lib/libmindopt.so.0.25.1

macOS

Run the following command and follow the prompts:

# Intel (x86_64) systems
bash mindopt-install-osx64x86-2.3.0.sh

# Apple Silicon (arm64) systems
bash mindopt-install-osx64aarch-2.3.0.sh

Directory structure after installation

After the installer finishes, the installation directory contains the following:

Check environment variables

Windows: The installer adds MINDOPT_HOME and Path automatically. To switch between installed versions, update the MINDOPT_HOME value.

Linux and macOS: The installer adds source ~/.mdo_profile to ~/.bashrc and ~/.zshrc. The changes take effect after you restart the terminal.

To apply them immediately without restarting:

cat ~/.mdo_profile   # view the current settings
source ~/.mdo_profile

To switch between installed versions, edit ~/.mdo_profile directly:

nano ~/.mdo_profile

In a Docker container, use export to check the variables.

Run a quick test

After loading the environment variables, run mindopt in the command line:

mindopt

A successful installation prints version and usage information to the terminal, similar to the output shown here:

Troubleshooting

Permission error: If mindopt fails to run, fix the executable permission:

# Linux
chmod u+x $MINDOPT_HOME/linux64-x86/bin/mindopt

# macOS
chmod u+x $MINDOPT_HOME/osx64-x86/bin/mindopt

macOS security block: macOS may prevent the binary from running due to developer security checks. In Security & Privacy, click Allow Anyway.

For other issues, see the Installation issues section in the FAQ.

Option 1: Cloud authentication (recommended)

Follow the steps in Configure an Alibaba Cloud account for authentication to get a license key and create the fl_client.ini license file. The solver runs locally on your machine. An internet connection is required only for authentication — no other information is uploaded.

Option 2: Offline authentication

Starting from 2024, purchase a local authentication license from the console. The license is tied to a machine fingerprint (machine ID) and supports offline, single-machine, unlimited concurrent use. For instructions on getting the machine fingerprint, see consoleHow to get the machine fingerprint for an offline fixed-machine license.

Set the license file location

Recommended: Set the MINDOPT_LICENSE_PATH environment variable to the folder containing the license file.

Linux and macOS:

export MINDOPT_LICENSE_PATH=$HOME/mindopt

Windows — set the environment variable in System Properties:

For more details, see License configuration.

Default location (if `MINDOPT_LICENSE_PATH` is not set):

V2.1 and later — Maven dependency (recommended)

Add the following dependency to your pom.xml. Set the classifier to match your platform:

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>2.1.0-SNAPSHOT</version>
  <classifier>osx-x64</classifier>
  <!-- macOS arm64  : osx-aarch -->
  <!-- linux arm64  : linux-aarch -->
  <!-- linux x86    : linux-x64 -->
  <!-- windows      : win-x64 -->
  <!-- all platforms: portable -->
  <type>jar</type>
</dependency>

V1.0 and later — built-in JAR

The installation package includes mindoptj.jar at <MDOHOME>/<VERSION>/<PLATFORM>/lib/mindoptj.jar. Reference it directly in pom.xml:

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>2.0.0</version>
  <scope>system</scope>
  <systemPath>${env.MINDOPT_HOME}/osx64-x86/lib/mindoptj.jar</systemPath>
</dependency>

V0.x.x — Maven dependency

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>[0.24.0, 1.0.0)</version>
</dependency>

Uninstall

Windows: Go to Control Panel > Programs and Features, find the MindOpt version, and right-click to uninstall. Each installed version appears as a separate entry. If you installed as an administrator, the uninstaller may not have permission to remove the MINDOPT_HOME and Path environment variables — remove them manually or run the uninstaller as an administrator.

Linux and macOS:

1. Delete the installation directory (for example, $HOME/mindopt).

2. Remove the source ~/.mdo_profile line from ~/.bashrc and ~/.zshrc, then delete ~/.mdo_profile.

Python APIs:

pip3 uninstall mindoptpy

If you plan to reinstall later, back up your license files before deleting the installation directory. Default license locations: $HOME/mindopt (Linux/macOS) and C:\Users\<username>\mindopt (Windows). Running example commands may generate .bas and .sol result files in the installation directory — delete these as needed.

Reinstall

Multiple SDK versions can coexist in separate folders. Set the environment variables for the version you want to use — no changes to the license file are required.

Windows: Double-click the installer. The new environment variable settings overwrite the previous ones. To switch between versions, update the directory in the MINDOPT_HOME environment variable.

Linux and macOS: Follow the installation steps above. Then update the version path in ~/.mdo_profile or in ~/.bashrc/~/.zshrc.