Repository files navigation

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

Features:

• TLS client certificate support
• single-userCGI
• distributed PKI: authorisation by subject orissuer of certificates
• Titan protocol uploads
• servlet interface for in-process dynamic page generation

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:

• Rebar3 installation instructions
• apt-get install erlang

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

Create an appropriatesys.config andvm.args file in theconfig/directory in the format suggested in the examples in that directory.

You'll also need to put TLS certificates inssl/certificate.pem andssl/key.pem; these locations can be reconfigured, but blizanci willfail on startup with abadmatch /couldnt_open_pem_file message ifthe certificates cannot be read.

$ rebar3 release

$ ./manage.sh start-daemon

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

A work in progress athttps://mk270.github.io/blizanci/.

The source code of Blizanci is largely "finished". There are no plans to add new features.

But software is more than just programs. There is already some documentation of blizanci's internal APIs - eventually a manual will be produced and some installation advice and packaging / tooling.