# Docker image for munin server ## Configuration 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` * `SMTP_PASSWORD` * `SMTP_USE_TLS` * `SMTP_ALWAYS_SEND` ### Alert target Email addressed used for the alerts, require SMTP credentials. * `ALERT_RECIPIENT` * `ALERT_SENDER` ### List of the nodes to check The port is always optional, default is 4949 * `NODES` format: `name1:ip1[:port1] name2:ip2[:port2] …` * `SNMP_NODES` format: `name1:ip1[:port1]` … ## Port Container is listening on the port 8080 ## Volumes For a bit of persistency * /var/log/munin -> logs * /var/lib/munin -> db * /var/run/munin -> lock and pid files * /var/cache/munin -> file deserved by HTTP ## How to use the image ``` docker build -t munin-server . 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 SMTP_USE_TLS=false \ -e SMTP_ALWAYS_SEND=true \ -e SMTP_MESSAGE='[${var:group};${var:host}] -> ${var:graph_title} -> warnings: ${loop<,>:wfields ${var:label}=${var:value}} / criticals: ${loop<,>:cfields ${var:label}=${var:value}}' \ -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. It will display at the first run: ``` Munin has not run yet. Please try again in a few moments. ``` Every 5 minutes munin-server will interrogate its nodes and build the graphs and store the data. That's only after the first data fetching operation that the first graphs will appear.