1 # gmid
2 
3 > A Gemini server
4 
5 gmid is a full-featured Gemini server written with security in mind.  It can serve static files, has an optional FastCGI and proxying support and a rich configuration syntax.
6 
7 gmid also bundles a small gemini client called ‘gg’ (gemini get), a small command-line server for quick testing called ‘gemexp’ and a titan implementation.
8 
9 => gmid.8.MANEXT	gmid(8) - Gemini server
10 => gmid.conf.5.MANEXT	gmid.conf(5) - gmid configuration file
11 => gg.1.MANEXT		gg(1) - gemini client
12 => gemexp.1.MANEXT	gemexp(1) - export a directory over Gemini
13 => titan.1.MANEXT	titan(1) - Titan client
14 
15 ## Install
16 
17 Some distros provide a package — thanks to the maintainers!
18 
19 => REPOLOGY	Repology: packaging status for gmid
20 
21 Otherwise, compile it from source: it’s easy and takes less than a minute on a raspberry pi 3
22 
23 => SITE/gmid-VERS.tar.gz	gmid-VERS.tar.gz
24 
25 => https://git.omarpolo.com/?action=summary&path=gmid.git git repository
26 => https://codeberg.org/op/gmid/		Codeberg mirror
27 => GITHUB					GitHub mirror
28 
29 The dependencies are:
30 
31 * libevent
32 * LibreSSL or OpenSSL
33 * yacc or GNU bison
34 
35 Once all the dependencies are installed, building is as easy as:
36 
37 ```Example of how to compile from source
38 $ curl -LO SITE/gmid-VERS.tar.gz
39 $ tar xzvf gmid-VERS.tar.gz
40 $ cd gmid-VERS
41 $ ./configure
42 $ make
43 $ sudo make install # eventually
44 ```
45 
46 A SHA256 file is available.  However, it only checks for accidental corruption.  You can use signify (gmid-VERS.sha256.sig) and the public key PUBKEY to cryptographically verify the downloaded tarball.  The signify public key for the previous and the next release is included in the tarball.
47 
48 => SITE/gmid-VERS.sha256	gmid-VERS.sha256
49 => SITE/gmid-VERS.sha256.sig	gmid-VERS.sha256.sig
50 
51 To verify the signatures with signify(1):
52 
53 ```Example of how to verify the signature with signify
54 % signify -C -p PUBKEY -x gmid-VERS.sha256.sig
55 Signature Verified
56 gmid-VERS.tar.gz: OK
57 ```
58 
59 Git tags are signed with the following ssh key:
60 
61 ```
62 ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIJ0nD5I8BNVJknT87gnpLIJWK0fXTayDktQOlS38CGj4 op@omarpolo.com
63 ```