💾 Archived View for gmid.omarpolo.com › contrib.gmi captured on 2021-12-04 at 18:04:22. Gemini links have been rewritten to link to archived content

View Raw

More Information

⬅️ Previous capture (2021-11-30)

➡️ Next capture (2021-12-17)

-=-=-=-=-=-=-

Home

Quickstart

docs

Contrib

This directory is for additional contributed files which may be useful.

Dockerfile

contrib/Dockerfile

A sample Dockerfile. The resulting image is a classic alpine linux image with a statically linked gmid installed as /bin/gmid.

To build the image:

# 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

gencert

contrib/gencert

contrib/gencert is a simple script to generate self-signed certificates.

OpenBSD rc file

contrib/gmid

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.

Systemd unit file

gmid.service

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:

• the ExecStart path may depend on the installation
• a ‘gmid’ user needs to be create for e.g. with

# useradd --system --no-create-home -s /bin/nologin -c "gmid Gemini server" gmid

• logs can be inspected with journalctl(1)

# journalctl -t gmid

renew certificates automatically

contrib/renew-certs

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

Vim syntax files

contrib/vim

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']

Screenshot of vim editing gmid.conf