diff options
author | Omar Polo <op@omarpolo.com> | 2024-08-03 10:49:39 +0000 |
---|---|---|
committer | Omar Polo <op@omarpolo.com> | 2024-08-03 10:49:39 +0000 |
commit | 69e34a630aa835783412477ebd41fed289361a71 (patch) | |
tree | d046a2be53eb1af51ecc139645cbb97c9445fdce | |
parent | 040f7aaca1032511212b4fbad28717dcfadc3d49 (diff) |
gmid.conf.5: some love for the EXAMPLES section
Few grammar and style fixes, plus add an example about logging on
a file.
Prodded by https://github.com/omar-polo/gmid/issues/34
-rw-r--r-- | gmid.conf.5 | 25 |
1 files changed, 20 insertions, 5 deletions
diff --git a/gmid.conf.5 b/gmid.conf.5 index f509c5a..66e4299 100644 --- a/gmid.conf.5 +++ b/gmid.conf.5 @@ -631,7 +631,7 @@ if no mapping was found. The following is an example of a possible configuration for a site that enables only TLSv1.3, adds the MIME types mapping from .Pa /usr/share/misc/mime.types -and defines two virtual host: +and defines two virtual hosts: .Bd -literal -offset indent protocols "tlsv1.3" @@ -657,9 +657,9 @@ server "example.it" { } .Ed .Pp -Yet another example, showing how to enable a +This example shows how to enable the .Ic chroot -and use +and use a .Ic location rule .Bd -literal -offset indent @@ -686,13 +686,28 @@ server "example.com" { } .Ed .Pp -This shows how to set up a reverse proxy: all request for +This example shows how to log requests to +.Pa /var/gemini/logs/access.log +when running in the +.Pa /var/gemini +chroot. +The file will be created if not exists. +.Bd -literal -offset indent +chroot "/var/gemini" +user "_gmid" + +log { + access "/logs/access.log" # relative to the chroot +} +.Ed +.Pp +This example shows how to set up a reverse proxy: all request for .Sq example.com will be forwarded to 10.0.0.6 transparently. Proxying establish a new TLS connection, so any client-certificates used to connect to .Xr gmid 8 -cannot be provided to the proxied server as well. +cannot be provided to the proxied server. .Bd -literal -offset indent server "example.com" { listen on * port 1965 |