blob: 832c8f8736d3bc929c7493e367920144b5688e1e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
# Frequently Asked Questions
## How can I report a bug, suggest a feature or send a patch?
Just drop an email to <gmid [at] omarpolo [dot] com> or open an issue/pull request on Codeberg or Github.
=> https://codeberg.org/op/gmid Codeberg mirror
=> https://github.com/omar-polo/gmid GitHub mirror
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.
## How can I define the right MIME types for my files?
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:
``` example of how to use the type rule in the configuration file
types {
application/postscript ps eps ai
application/rss+xml rss
# it's also possible to just include a file here
include "/usr/share/misc/mime.types"
}
```
## How to run CGI scripts?
As of gmid 2.0, to run CGI scripts an external program like fcgiwrap or slowcgi are needed.
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.
``` example configuration that runs a CGI via slowcgi
server "example.com" {
listen on *
cert "/path/to/cert"
key "/path/to/key"
location "/cgi-bin/hello" {
fastcgi {
socket "/run/slowcgi.sock"
param SCRIPT_NAME = "/cgi-bin/hello"
}
}
}
```
Then, fcgiwrap or slowcgi need to be started as well.
## How to automatically renew the certificates?
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.
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.
=> TREE/contrib/renew-certs contrib/renew-certs
|
