Go to file
Justus Winter 71d38ae865
Revert "web: ignore whitespace in searched fingerprints"
- ASCII whitespace, among them the space (0x20), was always ignored
    by Sequoia, therefore the change did not change what search terms
    were accepted.

  - This reverts commit ab3f4006dd.
2019-07-08 17:10:24 +02:00
contrib Use template systemd service file 2019-02-03 12:43:13 +00:00
database Revert "web: ignore whitespace in searched fingerprints" 2019-07-08 17:10:24 +02:00
dist about: add FAQ about mta-sts 2019-07-07 12:29:34 +02:00
hagridctl Bump Sequoia to 0.8. 2019-06-14 14:38:09 +02:00
src mail: set message id with own host in outgoing mail 2019-07-03 23:52:51 +02:00
.gitignore hagridctl: working import command 2019-06-05 18:25:32 +00:00
.gitlab-ci.yml ci: Print backtraces. 2019-03-12 14:28:22 +01:00
COPYING Add license notice and license text 2019-05-03 11:10:34 +02:00
Cargo.lock mail: set message id with own host in outgoing mail 2019-07-03 23:52:51 +02:00
Cargo.toml (revert mistakenly removed default-run in Cargo.toml) 2019-07-06 10:28:22 +02:00
README.md fork to https://gitlab.com/hagrid-keyserver/hagrid 2019-06-15 20:34:31 +02:00
Rocket.toml.dist web: add RequestOrigin request guard 2019-06-22 22:45:17 +00:00
build.rs fix warning in build.rs 2019-02-22 16:34:45 +01:00
hagrid-routes.conf nginx: be more flexible when handling full-uid --searches 2019-07-02 18:01:09 +00:00
nginx-site.conf split up nginx files 2019-02-27 11:39:38 +01:00
nginx.conf split up nginx files 2019-02-27 11:39:38 +01:00
rustfmt.toml use rustfmt to format source 2019-02-08 12:46:31 +01:00

README.md

Hagrid

Hagrid is a verifying OpenPGP key server.

You can find general instructions and an API documentation at the running instance at https://keys.openpgp.org.

License

Hagrid is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Hagrid is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with Hagrid. If not, see https://www.gnu.org/licenses/.

Quick Start

Building Hagrid requires a working nightly Rust toolchain. The easiest way to get the toolchain is to download rustup. After rustup is installed, get the nightly compiler and tools, copy the config file, and simply compile and run:

cd hagrid
rustup override set nightly
cp Rocket.toml.dist Rocket.toml
cargo run

This will spawn a web server listening on port 8080.

For deployment, a release build should be used (cargo build --release). This will be statically built, and can be copied anywhere. You will also need to adjust Rocket.toml accordingly. Hagrid uses sendmail for mailing, so you also need a working local mailer setup.

Reverse Proxy

Hagrid is designed to defer lookups to reverse proxy server like Nginx and Apache. Lookups via /vks/v1/by-finingerprint, /vks/v1/by-keyid, and /vks/v1/by-email can be handled by a robust and performant HTTP server. A sample configuration for nginx is part of the repository (nginx.conf, hagrid-routes.conf).

Community

We're in #hagrid on Freenode IRC, also reachable via Matrix as #hagrid:stratum0.org.