sheldond/README.md

42 lines
1.4 KiB
Markdown
Raw Normal View History

2020-05-14 19:45:59 +00:00
Sheldon Director
================
2020-05-15 08:57:15 +00:00
A [Gemini](https://gemini.circumlunar.space/) Server written in Rust.
2020-05-14 19:45:59 +00:00
2020-05-17 11:03:27 +00:00
Features
--------
This can't do much right now besides hosting some static files. In fact, the
feature set happens to be limited to what I need to host my own gemini page.
Coincidence?
More is to come however. Specifically I'd want to add CGI support. And maybe
reverse proxy support as well, depending on how much stuff I'll be hosting over
Gemini.
Starting
--------
Right now every relevant option needs to be given through command line
parameters. Though handling of a configuration file is a feature I'll add
later on.
An example start can look like this:
```sh
sudo ./sheldond -l "[::]:1965" -l "0.0.0.0:1965" -d "klockenschooster.de" -g /var/gemini/ --user gem-data --group gem-data
```
This serves the content of the folder `/var/gemini/` over both IPv4 and IPv6
on port 1965 on the domain `klockenschooster.de`. After opening the socket and
reading the certificates the server sets its user and group id to the
respective values for `gem-data`.
2020-05-14 19:45:59 +00:00
Why "Sheldon Director"?
-----------------------
Because it is the real name of that villain in _Kim Possible_ who went by the
pseudonym "Gemini". (https://kimpossible.fandom.com/wiki/Gemini)
2020-05-16 09:03:48 +00:00
Though you are free to imagine the shortened name stands for Sheldon Daemon.
But in that case you'll have to come up with your own explanation.