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 => GITHUB/releases/download/VERS/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 GITHUB/releases/download/VERS/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 (SHA256.sig and the public key gmid-CURV.pub) to cryptographically verify the downloaded tarball.  The signify public key for the next release ‘gmid-NEXTV.pub’ is also included.
47 
48 => GITHUB/releases/download/VERS/SHA256		SHA256
49 => GITHUB/releases/download/VERS/SHA256.sig	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 gmid-1.8.pub -x SHA256.sig
55 Signature Verified
56 gmid-VERS.tar.gz: OK
57 gmid-CURV.pub: OK
58 gmid-NEXTV.pub: OK
59 ```