authorSergey Poznyakoff <>2018-04-21 11:59:38 (GMT)
committer Sergey Poznyakoff <>2018-04-21 12:02:19 (GMT)
commit265d2886f8012e84860bbe66f299073ebefe7553 (patch) (side-by-side diff)
parent7482a103eb3b0663518d561a4ed1bf792e1a1f27 (diff)
Update docs
Diffstat (more/less context) (ignore whitespace changes)
2 files changed, 43 insertions, 7 deletions
diff --git a/README b/README
index 577ee9c..3311986 100644
--- a/README
+++ b/README
@@ -10,15 +10,27 @@ this case using e.g. Apache or even lighttpd just to serve
LetsEncrypt challenge requests arriving once in 90 days is clearly an
overkill. Instead, fileserv can be used.
-Start the program as
+Starting the server can be as simple as:
- fileserv -u nobody -a /.well-known/acme-challenge:/var/www/acme/
+ fileserv -u nobody -a /.well-known/acme-challenge:/var/www/acme
-It will be running in background with privileges of the user nobody,
+This instructs it to run in background with privileges of the user nobody
listening on localhost, port 8080. Requests with URL path beginning
with /.well-known/acme-challenge will be served from directory
/var/www/acme. Other requests will be rejected.
+It is more convenient to keep all settings in the configuration file.
+Its name is ${sysconfdir}/fileserv.conf, where ${sysconfdir} is
+determined when compiling the package. Normally, it is /etc or
+The above command line options are equivalent to the following
+ user nobody
+ listen
+ mapping /.well-known/acme-challenge:/var/www/acme
If the proxy used is pound[1], define the following service in its
configuration file /etc/pound.conf:
@@ -68,14 +80,34 @@ as described above.
* Documentation
-Manpage fileserv.3 included. After installing the package, run
+Manpage fileserv.8 included. After installing the package, run
man fileserv.
+* Bug reporting.
+Send bug reports to <>.
* References
[1] Pound -
[2] Haproxy -
[3] GNU Libmicrohttpd -
+* Copyright information:
+Copyright (C) 2017-2018 Sergey Poznyakoff
+ Permission is granted to anyone to make or distribute verbatim copies
+ of this document as received, in any medium, provided that the
+ copyright notice and this permission notice are preserved,
+ thus giving the recipient permission to redistribute in turn.
+ Permission is granted to distribute modified versions
+ of this document, or of portions of it,
+ under the above conditions, provided also that they
+ carry prominent notices stating who last changed them.
Local Variables:
mode: outline
diff --git a/src/fileserv.conf b/src/fileserv.conf
index 1b56676..5d24122 100644
--- a/src/fileserv.conf
+++ b/src/fileserv.conf
@@ -18,8 +18,11 @@
pidfile /var/run/
# Name of the MIME magic file. This file is used to determine the
-# types of the files being served or listed.
-mime-types-file /var/lib/fileserv/mime.types
+# types of the files being served or listed. E.g.:
+# mime-types-file /etc/fileserv/mime.types
+# Default is undefined
# Listen on the given interface
@@ -87,7 +90,8 @@ hidden-files '^\..*' '^#' '~$' '\.rej$' '\.orig$'
# At least one mapping must be defined.
-mapping /:/var/www/static
+mapping /:/var/www/htdocs
+mapping /.well-known/acme-challenge:/var/www/acme/
# Customized versions of error pages are looked up in the directory,

Return to:

Send suggestions and report system problems to the System administrator.