Requirements

Docker must be installed.

Installing

Blockade can be installed via pip or easy_install:

$ pip install blockade

Because Blockade executes iptables and tc commands, it must be installed on a Linux system or VM. It must be run as a user that has an ability to launch Docker containers. Typically this is done by adding the user to the docker group.

It is potentially possibly to make Blockade talk to a remote Docker API but this is not yet supported.

OSX

If you are using OSX, Blockade and Docker cannot yet be truly run natively. 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.