This is an outdated guide, please find latest version on our website now!

In this post I’d like to show how quickly one can get up-and-running using Weave with Docker Machine. This was made possible with our latest v0.10.0 release, which has many improvements including the ability to communicate with remote Docker host.

To follow this guide you will need to obtain the binaries for

If you are using OS X, then you can install these tools with Homebrew like this:

brew install docker docker-machine

You will need to download and install VirtualBox manually as well, if you haven’t done it yet. Please be sure to install latest version of Machine (v0.2.0), as there are some bugs in the previous release. You also want to use latest boot2docker VM image; you will get it if you haven’t used Docker Machine previously on your computer, otherwise you should delete cached ISO image located in ~/.docker/machine/cache/boot2docker.iso before you proceed.

Let’s proceed, it’s only a few steps!

First, we will provision a VirtualBox VM with docker-machine create, then run Weave script again new VM and setup a few test containers.

docker-machine create --driver=virtualbox weave-1
curl --silent --location --output ./weave
chmod +x ./weave

As I said, with Weave v0.10.0, you can run weave command agains a remote Docker host. You just need to make sure DOCKER_HOST environment variable is set, which docker-machine env does for you.

eval `docker-machine env weave-1`

Now you can launch Weave router and WeaveDNS.

./weave launch
./weave launch-dns

Running containers is also as pretty simple.

First, the server:

./weave run --with-dns 

Second a client:

./weave run --with-dns 
    --tty --interactive 

Now, let’s test it out:

> docker attach test-client

test:/# ping -c 3 hola.weave.local
PING hola.weave.local ( 56 data bytes
64 bytes from seq=0 ttl=64 time=0.130 ms
64 bytes from seq=1 ttl=64 time=0.204 ms
64 bytes from seq=2 ttl=64 time=0.155 ms

--- hola.weave.local ping statistics ---
3 packets transmitted, 3 packets received, 0% packet loss

test:/# curl hola.weave.local:5000
Hello, Weave!

What’s next?

You can easily extend this setup to more then one Docker hosts, here is a hint (best to use a new terminal window).

docker-machine create -d virtualbox weave-2
eval `docker-machine env weave-2`
./weave launch
./weave launch-dns
./weave connect `docker-machine ip weave-1`
./weave run ... # what do you want to run?

Next I am planning to post a full guide on how to use Weave with Machine, Swarm and Compose all 4 together, but you should also checkout Ben Firshman’s talk on how to use these as well as Flocker.

Do make sure to follow @weaveworks, so you don’t miss any new posts. You can always drop us a few lines to, to let us know what you think about Weave.