Maintained by: Gurobi Optimization
Where to get help: Gurobi Support, Gurobi Documentation
When building a production application, we recommend using an explicit version number instead of the latest tag.
This way, you are in control of the upgrade process of your application.
Supported architectures: linux amd64
Published image artifact details: https://github.com/Gurobi/docker-python-example
Gurobi images available on DockerHub:
- gurobi/optimizer: Gurobi Optimizer (full distribution)
- gurobi/python: Gurobi Optimizer (Python API only)
- gurobi/python-example: Gurobi Optimizer example in Python with a WLS license
- gurobi/modeling-examples: Optimization modeling examples (distributed as Jupyter Notebooks)
- gurobi/compute: Gurobi Compute Server
- gurobi/manager: Gurobi Cluster Manager
The Gurobi Optimizer is the fastest and most powerful mathematical programming solver available for your LP, QP and MIP (MILP, MIQP, and MIQCP) problems. More info at the Gurobi Website.
The Gurobi Optimizer comes with a Python extension module called “gurobipy” that offers convenient object-oriented modeling constructs and an API to all Gurobi features. More info in the Quick Start Guide.
The gurobi/python-example image provides a simple example to use gurobi/python as a base Docker image with the
Gurobi Web License Service:
- The Dockerfile shows how to customize the image
- The code in Python sets up the WLS license
- The optimization example is explained in the getting started
This image has been created to work with a Web License. The Web License Service (WLS) is a Gurobi licensing service for containerized environments (Docker, Kubernetes, ...). Gurobi components can automatically request and renew license tokens to the WLS servers available in several regions worldwide. WLS only requires that your container has access to the Internet. Commercial users can request an evaluation and academic users can request a free license. Please register to access the Web License Manager and read the documentation.
Please contact your sales representative at sales@gurobi.com to discuss licensing options.
This image has been created to pass the license information in the following environment variables:
- GRB_WLSACCESSID: Access ID for Gurobi Web License Service
- GRB_WLSSECRET: Secret Key for Gurobi Web License Service
- GRB_LICENSEID: License ID for Gurobi Web License Service
Running the example is quick and easy, you just need to pass the WLS license information as environment variables on the command line of docker.
$ docker run -e GRB_WLSACCESSID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
-e GRB_WLSSECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
-e GRB_LICENSEID=99999 \
gurobi/python-exampleIn the same way, you can run this image in various containerized environments.
By downloading and using this image, you agree with the End-User License Agreement for the Gurobi software contained in this image.
As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).
As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.