summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorSoulou <leo@unbekandt.eu>2015-12-14 00:17:25 +0100
committerSoulou <leo@unbekandt.eu>2015-12-14 00:17:45 +0100
commitca0a7c54f2e90e600edd02c85c1560afd291e506 (patch)
treed305cd6c2cb9c63fb7806d96dc6d0d5a626f69e3 /README.md
parent6ea618fce10f44f29f997f3d9d87bc301137ca2d (diff)
downloadmunin-ca0a7c54f2e90e600edd02c85c1560afd291e506.tar.gz
munin-ca0a7c54f2e90e600edd02c85c1560afd291e506.tar.bz2
munin-ca0a7c54f2e90e600edd02c85c1560afd291e506.tar.xz
munin-ca0a7c54f2e90e600edd02c85c1560afd291e506.zip
update README.md
Diffstat (limited to 'README.md')
-rw-r--r--README.md35
1 files changed, 34 insertions, 1 deletions
diff --git a/README.md b/README.md
index 83ef463..39ddeb4 100644
--- a/README.md
+++ b/README.md
@@ -6,11 +6,15 @@ All the configuration is done through the environment.
### HTTP Credentials
+These are the credentials used to authenticate the HTTP dashboard
+
* `MUNIN_USER`
* `MUNIN_PASSWORD`
### SMTP info for alerts
+Email credentials used to send emails (like alerts)
+
* `SMTP_HOST`
* `SMTP_PORT`
* `SMTP_USERNAME`
@@ -18,12 +22,17 @@ All the configuration is done through the environment.
### Alert target
+Email addressed used for the alerts, require SMTP credentials.
+
* `ALERT_RECIPIENT`
* `ALERT_SENDER`
### List of the nodes to check
-* `NODES` format: `name1:ip1 name2:ip2 …`
+The port is always optional, default is 4949
+
+* `NODES` format: `name1:ip1[:port1] name2:ip2[:port2] …`
+* `SNMP_NODES` format: `name1:ip1[:port1]` …
## Port
@@ -37,3 +46,27 @@ For a bit of persistency
* /var/lib/munin -> db
* /var/run/munin -> lock and pid files
* /var/cache/munin -> file deserved by HTTP
+
+## How to use the image
+
+```
+docker run -d \
+ -p 8080:8080 \
+ -v /var/log/munin:/var/log/munin \
+ -v /var/lib/munin:/var/lib/munin \
+ -v /var/run/munin:/var/run/munin \
+ -v /var/cache/munin:/var/cache/munin \
+ -e MUNIN_USER=http-user \
+ -e MUNIN_PASSWORD=secret-password \
+ -e SMTP_HOST=smtp.example.com \
+ -e SMTP_PORT=587 \
+ -e SMTP_USERNAME=smtp-username \
+ -e SMTP_PASSWORD=smtp-password \
+ -e ALERT_RECIPIENT=monitoring@example.com \
+ -e ALERT_SENDER=alerts@example.com \
+ -e NODES="server1:10.0.0.1 server2:10.0.0.2" \
+ -e SNMP_NODES="router1:10.0.0.254:9999"
+ munin-server
+```
+
+You can now reach your munin-server on port 8080 of your host.