Requirements

You need an accessible Docker Engine API, and the ability to launch privileged containers with host networking. Docker can be local or remote. If remote, set DOCKER_HOST and the other environment variables to configure the URL and credentials. Generally, if the docker cli works, so should Blockade.

Docker Swarm is not supported at this time.

Installing

Blockade can be installed via pip or easy_install:

$ pip install blockade

macOS or Windows

Blockade works on macOS either natively pointing to a remote Docker Engine API or via Docker for Mac.

Blockade does not support Windows native containers. Nor is it known to work with Docker for Windows, but this may be possible. One option is to run Blockade itself in a container, in daemon mode, and talk to it via the REST API.

Another great option is Vagrant, to run Blockade and Docker in a Linux VM. Use the included Vagrantfile or another approach to get Docker and Blockade installed into a Linux VM. If you have Vagrant installed, running vagrant up from the Blockade checkout directory should get you started. Note that this may take a while, to download needed VMs and Docker containers.