summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/README.md b/README.md
index b9e747d..faad164 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,32 @@
# foostats
Small Perl script reporting anonymous site stats for my foo.zone web and gemini capsule running on OpenBSD using `httpd` webserver and `relayd`, `inetd` + `vger` for Gemini.
+## Installation
+
+On OpenBSD, install dependencies:
+
+```sh
+doas pkg_add p5-Digest-SHA3 p5-PerlIO-gzip p5-JSON
+```
+
+## Usage
+
+To parse the logs, run:
+
+```sh
+doas perl foostats.pl --parse-logs
+```
+
+Note, expected are the logs in OpenBSD's "forwarded" format (see `httpd.conf(5)`).
+
+To fetch logs from partner server, run:
+
+```sh
+doas perl foostats.pl --replicate
+```
+
+To pretty print the (merged) logs, run:
+
+```sh
+doas perl foostats.pl --pretty-print
+```