Cog Relay written in Go supporting Docker and native command bundles
Go Shell Makefile Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Build Status Coverage Status Ebert Docker Build Statu


  • Go v1.9+
  • Docker v1.10.3+

Getting up and running

  1. Clone go-relay to $GOPATH/src/

    mkdir -p $GOPATH/src/
    git clone $GOPATH/src/
  2. Install preqrequisites

go get -u
  1. Download deps and compile an executable

  2. Set environment variables and run relay.

    You'll need to have a docker machine running and have environment variables set for the docker client to connect to it. If you haven't already, run the following. (See more details at

    docker-machine create --driver virtualbox default
    docker-machine start default
    eval $(docker-machine env default)`

    Then start relay:

    RELAY_DOCKER_USE_ENV=true _build/relay -file example_cog_relay.conf

Docker Images

Release images are available from the operable/relay repository on Docker Hub.

The latest code from the master branch is always available in the operable/relay-preview repository. The only tag in this repository is latest, and it "floats".

Building your own image can be done with make docker.