shinosaki / keyhoarder

Lightweight OpenPGP key server (HKP). Works on Cloudflare Workers

KeyHoarder

KeyHoarder is the open-source OpenPGP keyserver software. It provides HKP keyserver on Cloudflare Workers, Bun, Node.js.

Features

• Upload ascii armored OpenPGP keys
• Search for keys by Email address, Name or any query
• draft-gallagher-openpgp-hkp-00 compliant's key lookup.
• JSON formatted key lookup

Deploy

1. Set SITE_NAME from wrangler.toml.

   [vars]
   SITE_NAME = "My OpenPGP Keyserver"

2. Create KV namespaces. and append KV's id to wrangler.toml

   $ npx wrangler kv:namespace create keyhoarder

3. Deploy to Cloudflare Workers

   $ npm run deploy

Send/Search key with GnuPG

• --keyserver: Your keyserver hostname
• --search-keys: Your OpenPGP key's email address

Create key

$ gpg --full-key-gen

Send key to your keyserver

$ gpg --keyserver https://keys.example.com --send-keys <Your key's fingerprint>

Search key

$ gpg --keyserver https://keys.example.com --search-keys [email protected]

Dependencies

• Hono
• OpenPGP.js
• Zod

Author

Shinosaki

License

MIT