Skip to content

Latest commit

 

History

History
79 lines (55 loc) · 3.58 KB

readme.md

File metadata and controls

79 lines (55 loc) · 3.58 KB
Raw

OpenPGP Keyserver Website - Lite

This repository holds the website for my OpenPGP Keyserver, but the lite version of it.

This is a static site using bootstraps v3.3.2.

Using on your own site

This project is licensed under the GNU General Public License, version 2, with this license, you are free to download, modify, and share this project, as long as you persurve those same rights for others.

The content of this repository may be dropped directly in your webserver's content directory, with minor modification to update the contact method.

Installing

This is a simple "drop in site", as you only need to put the files in the correct spot for them to do there thing.

The simplist way of installing this site is via [git]](http://git-scm.com/), you may install it with the below commands.

Assuming your webserver will server data in /var/www/html:

git clone [email protected]:mattrude/pgpkeyserver-lite.git /var/www/html

If you do not wish to use git, you may just download it via the below command.

mkdir -p /var/www/html && \
curl -sL "https://github.com/mattrude/pgpkeyserver-lite/archive/master.tar.gz" |tar -xz --strip=1 -C /var/www/html/

Configuring

After downloading and extracting the tarball, you need to modify the site to reflect the setup of your keyserver. There are two sections that need to be replaced. first you need to replace all instances of ###ENTERNAMEHERE### with your own name. Next, replace the instance of ###ENTERPUBLICKEYHERE### with your public key. Or you may of course modify the site in anyway you wish.

You may also see other examples of configuration files in the wiki.

This project is intented to be served via a real webserver (nginx, apache, lighttpd), if you wish to run sks without a proxy setup, you may use the inline version of this project.

Nginx Configuration

#----------------------------------------------------------------------
# OpenPGP Public SKS Key Server
#----------------------------------------------------------------------

server {
    listen 80;
    listen [::]:80;
    listen <set-your-IP>:11371;
    listen [set-your-IPv6-IP]:11371;
    server_name <set-your-hostname>;
    server_name pool.sks-keyservers.net;
    server_name *.pool.sks-keyservers.net;
    server_name pgp.ipfire.org;
    server_name keys.gnupg.net;
    root /var/www/html;
    
    location ~ (.git|readme.md) {
        deny all;
        return 404;
    }
    
    location /pks {
        proxy_pass         http://127.0.0.1:11371;
        proxy_pass_header  Server;
        add_header         Via "1.1 <set-your-hostname>:11371 (nginx)";
    }
}

License

              GNU GENERAL PUBLIC LICENSE
                 Version 2, June 1991

Copyright (C) 2012-2015 Matt Rude <[email protected]>

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

This program 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 General Public License for more details.