aboutsummaryrefslogtreecommitdiff
path: root/mod/lorea-status/README
diff options
context:
space:
mode:
Diffstat (limited to 'mod/lorea-status/README')
-rw-r--r--mod/lorea-status/README38
1 files changed, 38 insertions, 0 deletions
diff --git a/mod/lorea-status/README b/mod/lorea-status/README
new file mode 100644
index 000000000..39ede84d4
--- /dev/null
+++ b/mod/lorea-status/README
@@ -0,0 +1,38 @@
+* Simple Lorea Seed Monitor
+
+Run an nginx static website to show current status of selected seeds.
+
+** How to setup the seed for using the monitor?
+
+*** Using PHP5-FPM (recommended)
+
+This is the recommended solution as it ensures the PHP process is running.
+
+: ping.path = /.ping
+: ping.response = pong example.org
+
+*** Using Apache
+
+Classical lorea setup.
+
+: echo 'pong example.org' > /var/www/example.org/.ping
+
+*** Using nginx
+
+New lorea setup.
+
+In =/etc/nginx/sites-available/example.org=:
+
+: location = /.ping {
+: default_type text/plain;
+: echo "pong $http_host";
+: echo_flush;
+: }
+
+** How do I add a seed to the monitor?
+
+Edit =/usr/local/bin/lorea_refresh_status= to add the domain name and
+the IP address of the server:
+
+: SEED[example.org]="203.0.103.123"
+