From 69e34a630aa835783412477ebd41fed289361a71 Mon Sep 17 00:00:00 2001 From: Omar Polo Date: Sat, 3 Aug 2024 10:49:39 +0000 Subject: 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 --- gmid.conf.5 | 25 ++++++++++++++++++++----- 1 file 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 -- cgit v1.2.3