gmid/site/index.gmi

64 lines
2.0 KiB
Plaintext
Raw Permalink Normal View History

2021-10-04 12:42:35 +02:00
# gmid
> A Gemini server
2024-01-05 21:14:02 +01:00
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.
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.
=> gmid.8.MANEXT gmid(8) - Gemini server
=> gmid.conf.5.MANEXT gmid.conf(5) - gmid configuration file
=> gg.1.MANEXT gg(1) - gemini client
=> gemexp.1.MANEXT gemexp(1) - export a directory over Gemini
=> titan.1.MANEXT titan(1) - Titan client
2021-10-04 12:42:35 +02:00
## Install
Some distros provide a package — thanks to the maintainers!
2022-01-28 09:34:39 +01:00
=> REPOLOGY Repology: packaging status for gmid
2021-10-04 12:42:35 +02:00
Otherwise, compile it from source: its easy and takes less than a minute on a raspberry pi 3
2021-10-04 12:42:35 +02:00
2024-01-11 13:44:09 +01:00
=> SITE/gmid-VERS.tar.gz gmid-VERS.tar.gz
2021-10-04 12:42:35 +02:00
2022-11-01 08:28:20 +01:00
=> https://git.omarpolo.com/?action=summary&path=gmid.git git repository
2022-07-04 16:48:18 +02:00
=> https://codeberg.org/op/gmid/ Codeberg mirror
2022-01-28 09:34:39 +01:00
=> GITHUB GitHub mirror
2021-10-04 12:42:35 +02:00
The dependencies are:
2021-10-04 12:42:35 +02:00
* libevent
2024-01-05 21:14:02 +01:00
* LibreSSL or OpenSSL
2021-10-04 12:42:35 +02:00
* yacc or GNU bison
Once all the dependencies are installed, building is as easy as:
```Example of how to compile from source
2024-01-11 13:44:09 +01:00
$ curl -LO SITE/gmid-VERS.tar.gz
2022-01-28 09:34:39 +01:00
$ tar xzvf gmid-VERS.tar.gz
$ cd gmid-VERS
2021-10-04 12:42:35 +02:00
$ ./configure
$ make
$ sudo make install # eventually
```
2024-01-11 13:44:09 +01:00
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.
2021-10-04 12:42:35 +02:00
2024-01-11 13:44:09 +01:00
=> SITE/gmid-VERS.sha256 gmid-VERS.sha256
2024-01-11 17:26:50 +01:00
=> SITE/gmid-VERS.sha256.sig gmid-VERS.sha256.sig
2021-10-04 12:42:35 +02:00
2024-01-11 13:44:09 +01:00
To verify the signatures with signify(1):
2021-10-04 12:42:35 +02:00
```Example of how to verify the signature with signify
2024-01-11 13:44:09 +01:00
% signify -C -p PUBKEY -x gmid-VERS.sha256.sig
2021-10-04 12:42:35 +02:00
Signature Verified
2022-07-04 21:18:30 +02:00
gmid-VERS.tar.gz: OK
2024-01-11 13:44:09 +01:00
```
Git tags are signed with the following ssh key:
```
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIJ0nD5I8BNVJknT87gnpLIJWK0fXTayDktQOlS38CGj4 op@omarpolo.com
2021-10-04 12:42:35 +02:00
```