💾 Archived View for gmid.omarpolo.com › contrib.gmi captured on 2022-03-01 at 15:02:51. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2021-12-17)
-=-=-=-=-=-=-
This directory is for additional contributed files which may be useful.
A sample Dockerfile. The resulting image is a classic alpine linux image with a statically linked gmid installed as /bin/gmid. Build the image with:
# docker build -f contrib/Dockerfile -t gmid .
and then run it with something along the lines of:
# docker run --rm -it -p 1965:1965 \
-v gmid.conf:/etc/gmid.conf:ro \
-v path/to/keys:/tls:ro \
-v /var/gemini:/var/gemini:ro \
gmid -c /etc/gmid.conf
contrib/gencert is a simple script to generate self-signed certificates.
contrib/gmid is a sample service file for OpenBSD rc(8). To install it:
# cp contrib/gmid /etc/rc.d
then the usual ‘rcctl [start|stop|enable|restart] gmid’ are available.
A simple service file for systemd. To install it
# cp contrib/gmid.service /lib/systemd/system/gmid.service
then the usual ‘systemctl [status|start|enable|stop] gmid’ commands can be used to manage the server.
Some things to keep in mind:
# useradd --system --no-create-home -s /bin/nologin -c "gmid Gemini server" gmid
# journalctl -t gmid
NB: this script requires features that are currently available only in the master branch.
contrib/renew-certs is a script meant to be run in a crontab that watch for certificate expiration. It can optionally renew the certs and restart gmid too.
Read the documentation with: perldoc renew-certs
contrib/vim contains a syntax highlighting for vim. To install it, just copy the files to ~/.vim or to /usr/share/vim/vimfiles, e.g.:
$ mkdir -p ~/.vim $ cp -R contrib/vim/* ~/.vim/
To enable Syntastic checker, add to your vimrc:
let g:syntastic_gmid_checkers = ['gmid']
