Table of Contents
NEWS
We are pleased to announce the release of Hockeypuck 2.3.
Hockeypuck is a modern synchronising keyserver that is optimised for ease of deployment, particularly in containerised environments via docker-compose.
Hockeypuck 2.3
Hockeypuck 2.3 is primarily a technical-debt release, but also adds features to ease the upgrade process in a production environment.
Features
- Updates to the PostgreSQL table schemas (https://github.com/hockeypuck/hockeypuck/pull/408)
- Offline, in-place reload of all key material (https://github.com/hockeypuck/hockeypuck/pull/404)
- Online reindexing of table schemas (https://github.com/hockeypuck/hockeypuck/pull/393)
- PKS support (https://github.com/hockeypuck/hockeypuck/pull/392)
There are no breaking changes between the 2.2 and 2.3 branches, and SKS sync is supported between 2.2 and 2.3 peers.
The 2.3 release adds support for online reindexing of the database schema, and offline dump-less reloading of the dataset. Reindexing is enabled by default, and will ensure that the schema is always updated to the latest version. Offline dump-less reload is implemented by a separate utility, hockeypuck-reload - see https://hockeypuck.io/upgrading.html#TOC_1.2. for instructions.
Due to changes in the database schema, it is strongly recommended to upgrade to 2.3 as soon as possible. Hockeypuck 2.4 will be released in early 2026, and will require the new schema to support RFC9580 and HKPv2.
2.3 also adds support for PKS-over-email and PKS-over-HTTP unidirectional sync. This is not enabled by default - see https://hockeypuck.io/configuration.html#TOC_1.4.1. and https://hockeypuck.io/configuration.html#TOC_1.5. for configuration details.
Hockeypuck 2.3 development is kindly supported by NGI Zero Core.
Installation and upgrading
You can install it by cloning the repo from https://github.com/hockeypuck/hockeypuck and checking out the branch branch-2.3, then following the instructions in the README.md file. You should not deploy from the master branch or the latest docker image in production.