2.0 KiB
gemini
This is a Gemini server for ad-hoc hosting. It depends on a TLS termination service like Nginx or HAProxy. This allow us to configure TLS like we need to and offload safety to a better reviewed project.
Installation
crystal build --release src/gemini.cr
strip --strip-all ./gemini
install -m 755 ./gemini /usr/local/bin/gemini
# Or
make gemini
sudo make install
Usage
gemini runs on port 19650/tcp without security on. Make sure to keep
this port closed on your firewall, but open 1965/tcp for TLS
connections.
gemini expects to serve files from the directory it's run from, and
serves several hosts under their own directory.
# Enter the directory you're hosting capsules from
cd /srv/gemini
# Create a directory for the capsule
install -dm 750 -o user -g gemini gemini.sutty.coop.ar
# Create a Gemtext file
echo "Hi" > gemini.sutty.coop.ar/index.gmi
# Run the server
gemini
Configure your Nginx server to proxy Gemini requests to
gemini. There's an example configuration on contrib/.
To test your setup, visit gemini://gemini.sutty.coop.ar
Self-signed certificates
The example configuration reuses the Let's Encrypt certificates we already issue at Sutty for our sites. If you want to use a self-signed certificate, GnuTLS provides the simplest way.
certtool --generate-privkey --outfile gemini.key
certtool --generate-self-signed --load-privkey gemini.key --outfile gemini.crt
The only fields required are CN for your domain, and a certification
duration in days, you can press Enter for everything else.
Development
You'll need to install Crystal ~>1.2.2.
Contributing
# 1. Fork it
git clone https://gitea.sutty.coop.ar/Sutty/gemini.git
cd gemini
git remote rename origin upstream
# 2. Work on your changes
# [...]
# 3. Send patches
git format-patch upstream
git send-email --to=f@sutty.coop.ar *.patch