This repository contains a small web app that serves as a GUI interface for editing and loading models into optimization solvers, solving the resulting models and returning results directly from your web browser without external services. You can run this app either on your local machine using Docker or even install it on a remote machine.
It uses SYMPHONY from COIN-OR as the underlying optimization framework. The web app uses a light-weight webserver (written in GO).
The original was written by Patrick Wieschollek, Thanks, Patrick!
Install and Use From Docker Hub
This image is now on Docker Hub. To use, simply install Docker (see instructions below) and then do
docker run -p PORT:9090 tkralphs/symphony-web
The image will automatically be pulled the first time you use it. In Windows and OS X, you can then fire up the Web browser and point it at either
http://***.***.**.**:3333/`
where ***.***.**.**
is the IP address of the Docker machine, which you can
retrieve by the command
docker-machine ip default
In Linux, point your browesr instead at
http://localhost:3333/`
Build from Source
Ubuntu
Just clone the repository and build the docker image by
git clone https://github.com/tkralphs/symphony-web
cd symphony-web
sudo docker build -t symphony-web image/
To launch the application (listening on Port 9090 inside docker) use
sudo docker run -p PORT:9090 symphony-web
which forwards the port 9090 (inside docker) to PORT on your machine.
If you use -p 3333:9090
, then point your browser to http://localhost:3333/
.
Windows
First install Docker for Windows. Depending on whether you are using a recent version of Windows, you may need to enable virtualization in the BIOS settings. For details, see
https://docs.docker.com/engine/installation/windows
As of this writing, it's important that you let Docker install Git for Windows (do not uncheck the box for installing git in the installer, even though it indicates that it is optional). After installing, run the "Docker Quickstart Terminal" application. Make a note of the IP address assigned to the docker machine (something like 192.168.99.100).
From the terminal clone the repository and build the docker image by the commands
git clone https://github.com/tkralphs/symphony-web.git
cd symphony-web
docker build -t symphony-web image/
To launch the application (listening on Port 9090 inside the docker) use
docker run -p PORT:9090 symphony-web
which forwards the port 9090 (inside docker) to PORT on your machine. If you
use -p 3333:9090
, then point your browser to http://***.***.**.**:3333/
,
where ***.***.**.**
is the IP address of the Docker machine, noted earlier.
Mac OSX
Since Docker is a bit more difficult to get running on OSX than on Linux, this
is some additional documentation for the OSX crowd. OSX is not like
Linux---virtualization is not built into the kernel. Therefore, we need to run
the docker machine inside another VM. For this, we need virtualbox. The
instructions below are for installing virutalbox with homebrew
, which seems
to work very well. (Caveat: I first found some old instructions on how to do
this and took a round-about path to the installation. Therefore, the list of
commands below is not exactly what I did. However, I think it's the right
incantation if you're starting from scratch with an updated install of
homebrew.)
Update: There now seems to be a trouble-free installation of Docker on OS X as
a native app. I haven't tried this, but I guess it should work well and might
be preferable is you are not already using homebrew
.
First, install virtualbox
brew update
brew tap caskroom/cask
brew cask install virtualbox
Now install docker
and docker-machine
brew install docker
brew install docker-machine
Create a new docker server to run in virtualbox and set environment variables so docker knows how to connect to it.
docker-machine create --driver virtualbox default
eval "$(docker-machine env default)"
Now follow instructions as above for building the container
git clone https://github.com/PatWie/symphony-web.git
cd symphony-web/
docker build -t symphony-web image/
Finally, start up the server and the container
docker-machine start default
docker run -d -p PORT:9090 symphony-web
where PORT
is the port you want to use for accessing the server on the host
machine (the second port 9090
is the port used by the docker machine running
inside virtual box). Finally, find out what IP address is assigned to the VM
with
docker-machine ip default
For example, on my OSX box, it is
OSX: ~/symphony-web> docker-machine ip default
192.168.99.100
Finally, point your browser to the IP address of the VM and the port number from above, i.e.
192.168.99.100:PORT
If you want to be fancy, you can give the docker VM a name with something like
echo $(docker-machine ip default) dockerhost | sudo tee -a /etc/hosts