1 # gmid
2 
3 > A Gemini server
4 
5 ## Features
6 
7 * sandboxed by default on OpenBSD, FreeBSD and Linux
8 * able to reload the configuration on-the-fly without loosing connections
9 * punycode and IRI support
10 * reverse proxying
11 * CGI and FastCGI support
12 * virtual hosts and per-location rules
13 * low memory footprint
14 * event-based asynchronous I/O model
15 * rich configuration file
16 
17 gmid also bundles a small gemini client called ‘gg’ (gemini get)
18 
19 => gmid.1.MANEXT	gmid(1) manpage
20 => gmid.conf.5.MANEXT	gmid.conf(5) manpage
21 => gg.1.MANEXT		gg(1) manpage
22 
23 ## Install
24 
25 Some distros provide a package — thanks to the maintainers!
26 
27 => REPOLOGY	Repology: packaging status for gmid
28 
29 Source code and precompiled binaries for linux are available:
30 
31 => GITHUB/releases/download/VERS/gmid-VERS.tar.gz	gmid-VERS.tar.gz
32 => GITHUB/releases/download/VERS/gmid-VERS.tar.bz2	gmid-VERS.tar.bz2
33 
34 => https://git.omarpolo.com/gmid/		git repository
35 => gemini://git.omarpolo.com/gmid.git/		git repository via Gemini
36 => GITHUB					GitHub mirror
37 
38 => GITHUB/releases/download/VERS/gmid.linux.aarch64	gmid.linux.aarch64
39 => GITHUB/releases/download/VERS/gmid.linux.amd64	gmid.linux.amd64
40 
41 When in doubt, compile from source: it’s easy and takes less than a minute on a raspberry pi 3.  The dependencies are:
42 
43 * libevent
44 * OpenSSL/LibreSSL
45 * libtls (from either LibreSSL or LibreTLS)
46 * yacc or GNU bison
47 
48 Once all the dependencies are installed, building is as easy as:
49 
50 ```Example of how to compile from source
51 $ curl -LO GITHUB/releases/download/VERS/gmid-VERS.tar.gz
52 $ tar xzvf gmid-VERS.tar.gz
53 $ cd gmid-VERS
54 $ ./configure
55 $ make
56 $ sudo make install # eventually
57 ```
58 
59 A SHA256 file is available.  However, that only checks for accidental corruption: you can use signify (SHA256.sig and the public key gmid-CURV.pub) or GPG.  The hash of the signify public key is also included in the SHA256 file and thus signed with my GPG.  The signify public key for the next release ‘gmid-NEXTV.pub’ is also included.
60 
61 => GITHUB/releases/download/VERS/SHA256		SHA256
62 => GITHUB/releases/download/VERS/SHA256		SHA256.gpg
63 => GITHUB/releases/download/VERS/SHA256.sig	SHA256.sig
64 
65 To verify the signatures with signify(1)
66 
67 ```Example of how to verify the signature with signify
68 % signify -C -p gmid-1.8.pub -x SHA256.sig
69 Signature Verified
70 gg.linux.amd64: OK
71 gmid-1.8.2-binaries.tar.gz: OK
72 gmid-1.8.2.tar.gz: OK
73 gmid-1.8.pub: OK
74 gmid-1.9.pub: OK
75 gmid.linux.amd64: OK
76 ```