WarpEngineer / blizanci

A Gemini protocol server

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

blizanci

Blizanci is a Gemini protocol server. It is designed primarily for robustness and security.

Features:

  • TLS client certificate support
  • single-user CGI
  • distributed PKI: authorisation by subject or issuer of certificates
  • Titan protocol uploads

Prerequisites

You'll need Erlang and Rebar. On a Debian-derived system like Ubuntu, this means installing the rebar3 executable from the rebar3 website, and installing the deb package erlang:

Config

Currently, a config file is required. In due course, this will become optional.

Create an appropriate sys.config and vm.args file in the config/ directory in the format suggested in the examples in that directory.

You'll also need to put TLS certificates in ssl/certificate.pem and ssl/key.pem; these locations can be reconfigured, but blizanci will fail on startup with a badmatch / couldnt_open_pem_file message if the certificates cannot be read.

Build

$ rebar3 release

Run

$ ./manage.sh start-daemon

Trivia

"blizanci" / "близанци" is Serbo-Croatian for "twins" (i.e., Gemini).

Documentation

A work in progress at https://mk270.github.io/blizanci/.

About

A Gemini protocol server

License:Apache License 2.0


Languages

Language:Erlang 94.3%Language:Python 3.7%Language:Shell 1.6%Language:Makefile 0.4%