1 # contributed files
2 
3 This directory is for additional contributed files which may be useful.
4 
5 ## Dockerfile
6 
7 => TREE/contrib/Dockerfile contrib/Dockerfile
8 
9 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:
10 
11 ```instructions to build the image
12 # docker build -f contrib/Dockerfile -t gmid .
13 ```
14 
15 and then run it with something along the lines of:
16 
17 ```instruction to run the image
18 # docker run --rm -it -p 1965:1965      \
19         -v gmid.conf:/etc/gmid.conf:ro  \
20         -v path/to/keys:/tls:ro         \
21         -v /var/gemini:/var/gemini:ro   \
22         gmid -c /etc/gmid.conf
23 ```
24 
25 ## gencert
26 
27 => TREE/contrib/gencert contrib/gencert
28 
29 contrib/gencert is a simple script to generate self-signed certificates.
30 
31 ## OpenBSD rc file
32 
33 => TREE/contrib/gmid contrib/gmid
34 
35 contrib/gmid is a sample service file for OpenBSD rc(8).  To install it:
36 
37 ```command to install the rc file
38 # cp contrib/gmid /etc/rc.d
39 ```
40 
41 then the usual ‘rcctl [start|stop|enable|restart] gmid’ are available.
42 
43 ## systemd unit file
44 
45 => TREE/contrib/gmid.service contrib/gmid.service
46 
47 A simple service file for systemd.  To install it
48 
49 ```instructions to install the system file
50 # cp contrib/gmid.service /lib/systemd/system/gmid.service
51 ```
52 
53 then the usual ‘systemctl [status|start|enable|stop] gmid’ commands can be used to manage the server.
54 
55 Some things to keep in mind:
56 * the ExecStart path may depend on the installation
57 * a ‘gmid’ user needs to be create for e.g. with
58 
59 ```how to create a dedicated user
60 # useradd --system --no-create-home -s /bin/nologin -c "gmid Gemini server" gmid
61 ```
62 
63 * logs can be inspected with journalctl(1)
64 
65 ```reads gmid logs with journalctl
66 # journalctl -t gmid
67 ```
68 
69 ## renew certificates automatically
70 
71 => TREE/contrib/renew-certs contrib/renew-certs
72 
73 NB: this script requires features that are currently available only in the master branch.
74 
75 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.
76 
77 Read the documentation with: perldoc renew-certs
78 
79 ## vim syntax files
80 
81 => TREE/contrib/vim contrib/vim
82 
83 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.:
84 
85 ```install the vim syntax highlight in your home
86 $ mkdir -p ~/.vim
87 $ cp -R contrib/vim/* ~/.vim/
88 ```
89 
90 To enable Syntastic checker, add to your vimrc:
91 
92 ```
93 let g:syntastic_gmid_checkers = ['gmid']
94 ```
95 
96 => vim-screenshot.png Screenshot of vim editing gmid.conf