Install from Source

Build Dependencies

Go

Install Go 1.1 or newer from golang.org.

On Ubuntu, the Juju PPA contains more recent versions of the Go language compiler and tools than the official releases:

$ sudo apt-add-repository ppa:juju/golang
$ sudo apt-get update
$ sudo apt-get install golang-go

Set up your Go language environment variables.

DVCS Clients

Go will need these DVCS clients installed in order to provision the source code to Hockeypuck's package dependencies:

  • Bazaar
  • Git
  • Mercurial

On Ubuntu:

$ sudo apt-get install bzr git mercurial

Build

Check out the Hockeypuck sources, with all its package dependencies into your Go development workspace with:

$ go get github.com/hockeypuck/hockeypuck

Hockeypuck uses godeps to manage package dependencies, setting them to a known good revision against which Hockeypuck has been tested. Use the Makefile for a proper, production-worthy build:

$ make build

This will compile hockeypuck to build/bin/hockeypuck.

Install

Binaries

Copy the Hockeypuck binary, build/bin/hockeypuck, into your $PATH.

Media

Hockeypuck will need to access the static media files (Go HTML templates, images, CSS, JS and fonts). These files will have been checked out into $GOPATH/src/github.com/hockeypuck/hockeypuck/instroot/var/lib/hockeypuck/www in the above steps. If Hockeypuck is run with the same $GOPATH environment variable set, it will be able to automatically locate these files when running the service.

Otherwise, you will need to set the hockeypuck.hkp.webroot configuration setting to the installed location of these files.

Next Steps

Now you have compiled static Hockeypuck binaries in $GOPATH/bin, you're ready to run. Move on to Configuration to set up your Hockeypuck service.

Contents © 2014 Casey Marshall - Powered by Nikola