This is a fork of Docker Machine repository with added support of Parallels Desktop for Mac. This is a temporary solution for those who want to use Docker Machine v0.4.0 with Parallels Desktop.

We expect that an official support of parallels driver will be available in Docker Machine v0.5.0, when the new plugin model will be implemented.

• OS X 10.9 of later
• Parallels Desktop 11 Pro or Business edition.

In order to use Docker Machine with Parallels Desktop you should install our custom docker-machine binary:

$ curl -L https://github.com/Parallels/docker-machine/releases/download/parallels%2F0.4.0-1/docker-machine_darwin-amd64 > /usr/local/bin/docker-machine

$ chmod +x /usr/local/bin/docker-machine

NB! This is a replacement for the official docker-machine binary. If you will install or update "Docker Toolbox" in the future, it could override this binary and you migth want to re-download it again.

Official documentation for Docker Machine is available here.

To create a Parallels Desktop virtual machine for Docker purposes just run this command:

$ docker-machine create --driver=parallels prl-dev

Available options:

• --parallels-boot2docker-url: The URL of the boot2docker image.
• --parallels-disk-size: Size of disk for the host VM (in MB).
• --parallels-memory: Size of memory for the host VM (in MB).
• --parallels-cpu-count: Number of CPUs to use to create the VM (-1 to use the number of CPUs available).

The --parallels-boot2docker-url flag takes a few different forms. By default, if no value is specified for this flag, Machine will check locally for a boot2docker ISO. If one is found, that will be used as the ISO for the created machine. If one is not found, the latest ISO release available on boot2docker/boot2docker will be downloaded and stored locally for future use. Note that this means you must run docker-machine upgrade deliberately on a machine if you wish to update the "cached" boot2docker ISO.

This is the default behavior (when --parallels-boot2docker-url=""), but the option also supports specifying ISOs by the http:// and file:// protocols.

Environment variables and default values:

Docker Client is required to run Docker containers. It is bundled to Docker Toolbox

$ docker-machine create -d parallels prl-dev
Creating CA: /Users/legal/.docker/machine/certs/ca.pem
Creating client certificate: /Users/legal/.docker/machine/certs/cert.pem
Image cache does not exist, creating it at /Users/legal/.docker/machine/cache...
No default boot2docker iso found locally, downloading the latest release...
Downloading https://github.com/boot2docker/boot2docker/releases/download/v1.8.1/boot2docker.iso to /Users/legal/.docker/machine/cache/boot2docker.iso...
Creating SSH key...
Creating Parallels Desktop VM...
Starting Parallels Desktop VM...
Waiting for VM to come online...
To see how to connect Docker to this machine, run: docker-machine env prl-dev

$ docker-machine ls
NAME       ACTIVE   DRIVER       STATE     URL                         SWARM
prl-dev    *        parallels    Running   tcp://10.211.55.3:2376

$ eval "$(docker-machine env prl-dev)"

$ docker run busybox echo hello world
Unable to find image 'busybox:latest' locally
latest: Pulling from library/busybox
cf2616975b4a: Pull complete
6ce2e90b0bc7: Pull complete
8c2e06607696: Pull complete
Digest: sha256:df9e13f36d2d5b30c16bfbf2a6110c45ebed0bfa1ea42d357651bc6c736d5322
Status: Downloaded newer image for busybox:latest
hello world