1 445816c2 2022-04-07 op # Frequently Asked Questions
3 445816c2 2022-04-07 op ## How can I report a bug, suggest a feature or send a patch?
5 6660c0bd 2024-01-05 op Just drop an email to <gmid [at] omarpolo [dot] com> or open an issue/pull request on Codeberg or Github.
7 6660c0bd 2024-01-05 op => https://codeberg.org/op/gmid Codeberg mirror
8 6660c0bd 2024-01-05 op => https://github.com/omar-polo/gmid GitHub mirror
10 6660c0bd 2024-01-05 op When reporting a bug please include the relevant information to reproduce the issue you're facing: your configuration file, the gmid version, and your operating system or distro at least.
13 445816c2 2022-04-07 op ## How can I define the right MIME types for my files?
15 445816c2 2022-04-07 op gmid, like many other servers, uses a list of known file extensions to decide what MIME type use. A few of them are built-in for convenience but it's quite easy to add custom ones:
17 445816c2 2022-04-07 op ``` example of how to use the type rule in the configuration file
19 445816c2 2022-04-07 op application/postscript ps eps ai
20 445816c2 2022-04-07 op application/rss+xml rss
22 445816c2 2022-04-07 op # it's also possible to just include a file here
23 445816c2 2022-04-07 op include "/usr/share/misc/mime.types"
28 6660c0bd 2024-01-05 op ## How to run CGI scripts?
30 6660c0bd 2024-01-05 op As of gmid 2.0, to run CGI scripts an external program like fcgiwrap or slowcgi are needed.
32 6660c0bd 2024-01-05 op From the gmid side, one `fastcgi' block needs to be defined with the `socket' pointing at the fcgiwrap or slowcgi socket inside the chroot. The `SCRIPT_NAME' parameter pointing to the script path is often needed since gmid is unable to deduce the right path otherwise.
34 6660c0bd 2024-01-05 op ``` example configuration that runs a CGI via slowcgi
35 6660c0bd 2024-01-05 op server "example.com" {
37 6660c0bd 2024-01-05 op cert "/path/to/cert"
38 6660c0bd 2024-01-05 op key "/path/to/key"
40 6660c0bd 2024-01-05 op location "/cgi-bin/hello" {
42 6660c0bd 2024-01-05 op socket "/run/slowcgi.sock"
43 6660c0bd 2024-01-05 op param SCRIPT_NAME = "/cgi-bin/hello"
49 6660c0bd 2024-01-05 op Then, fcgiwrap or slowcgi need to be started as well.
52 6660c0bd 2024-01-05 op ## How to automatically renew the certificates?
54 6660c0bd 2024-01-05 op It depends on how the certificate were obtained. For example, if acme-client or certbot are used they provide their own mechanism to renew the certs and restart daemons.
56 6660c0bd 2024-01-05 op In case of a self-signed certificate, contrib/renew-certs could help. It's meant to be scheduled periodically with cron(8) and automatically generate a new key and certificate when one is about to expire and restarts gmid.
58 6660c0bd 2024-01-05 op => TREE/contrib/renew-certs contrib/renew-certs
