1. Install with Docker

Probably the simplest way to get up to speed with Hockeypuck is using Docker and docker-compose.

2. Prerequisites

Any host being able to run a somewhat recent version of git and docker-compose is suitable.

3. Install Hockeypuck

git clone --config core.autocrlf=false https://github.com/hockeypuck/hockeypuck
cd hockeypuck/contrib/docker-compose/devel
docker-compose build

Beware that if you are building a docker image under Windows, you MUST disable autocrlf as above, otherwise the docker container will fail to start.

4. Configure Hockeypuck

Edit the configuration file in ./etc/hockeypuck.conf as necessary.

5. Populate and start the service

Populate the ./keydump/ directory with a keydump, e.g. from a location listed in the Data Sources.

Run the docker images:

docker-compose up -d

This will first import the keydump; expect this to take a day at least. To follow the progress or see error messages, use:

docker-compose logs --follow

6. Make available as HTTPS

The easiest way to make this or any other service available under HTTPS is to use https-portal. Clone it in a separate directory, and edit docker-compose.yml to include:

environment:
  DOMAINS: |
    keyserver.example.com -> http://dockerhost:11371,

You can add more redirects, proxies, and native directories easily by appending it to the DOMAINS environment variable.

Authors