This fork is officially deprecated in favor of Parallels Driver for Docker Machine, which is compatible with Docker Machine 0.5.0+
The code and documentation here only exist as a reference for users who have not yet switched over and want to use Docker Machine v0.4.0 with Parallels Desktop for Mac.
This is a fork of Docker Machine repository with added support of Parallels Desktop for Mac.
- 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-machineNB! 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 might 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:
| CLI option | Environment variable | Default |
|---|---|---|
--parallels-boot2docker-url |
PARALLELS_BOOT2DOCKER_URL |
Latest boot2docker url |
--parallels-cpu-count |
PARALLELS_CPU_COUNT |
1 |
--parallels-disk-size |
PARALLELS_DISK_SIZE |
20000 |
--parallels-memory |
PARALLELS_MEMORY_SIZE |
1024 |
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