4 3e4749f7 2020-10-02 op **gmid** - dead simple gemini server
10 3e4749f7 2020-10-02 op \[**-c** *cert.pem*]
11 3e4749f7 2020-10-02 op \[**-d** *docs*]
12 3e4749f7 2020-10-02 op \[**-k** *key.pem*]
17 3e4749f7 2020-10-02 op is a very simple and minimal gemini server.
18 3e4749f7 2020-10-02 op It only supports serving static content, and strive to be as simple as
22 3e4749f7 2020-10-02 op will strip any sequence of
26 3e4749f7 2020-10-02 op in the requests made by clients, so it's impossible to serve content
29 3e4749f7 2020-10-02 op directory by mistake.
30 6980aad6 2020-10-02 op Furthermore, on
35 3e4749f7 2020-10-02 op are used to ensure that
37 3e4749f7 2020-10-02 op dosen't do anything else than read files from the given directory and
38 3e4749f7 2020-10-02 op accept network connections.
40 3e4749f7 2020-10-02 op It should be noted that
42 3e4749f7 2020-10-02 op is very simple in its implementation, and so it may not be appropriate
43 3e4749f7 2020-10-02 op for serving site with lots of users.
44 3e4749f7 2020-10-02 op After all, the code is single threaded and use a single process.
46 3e4749f7 2020-10-02 op The options are as follows:
48 3e4749f7 2020-10-02 op **-c** *cert.pem*
50 3e4749f7 2020-10-02 op > The certificate to use, by default is
55 3e4749f7 2020-10-02 op > The root directory to serve.
57 3e4749f7 2020-10-02 op > won't serve any file that is outside that directory.
61 3e4749f7 2020-10-02 op > Print the usage and exit
63 3e4749f7 2020-10-02 op **-k** *key.pem*
65 3e4749f7 2020-10-02 op > The key for the certificate, by default is
70 3e4749f7 2020-10-02 op To quickly getting started
72 3e4749f7 2020-10-02 op $ # generate a cert and a key
73 3e4749f7 2020-10-02 op $ openssl req -x509 -newkey rsa:4096 -keyout key.pem \
74 3e4749f7 2020-10-02 op -out cert.pem -days 365 -nodes
76 3e4749f7 2020-10-02 op $ cat <<EOF > docs/index.gmi
78 3e4749f7 2020-10-02 op test paragraph...
80 3e4749f7 2020-10-02 op $ gmid -c cert.pem -k key.pem -d docs
82 6980aad6 2020-10-02 op now you can visit gemini://localhost/ with your preferred gemini client.
86 3e4749f7 2020-10-02 op * it doesn't support virtual host: the host part of the request URL is
87 3e4749f7 2020-10-02 op completely ignored.
89 3e4749f7 2020-10-02 op * it doesn't fork in the background or anything like that.