All the configuration is done through the environment.
These are the credentials used to authenticate the HTTP dashboard; both take a space-delimited list
MUNIN_USERS
MUNIN_PASSWORDS
Email credentials used to send emails (like alerts)
SMTP_HOST
- Host to send emails throughSMTP_PORT
- Port to use onSMTP_HOST
- default: 25SMTP_USERNAME
- Enables AuthenticationSMTP_PASSWORD
- Password for AuthenticationSMTP_USE_TLS
- Enables SSL/TLS onSMTP_PORT
toSMTP_HOST
SMTP_ALWAYS_SEND
- Sends all munin alerts
Email addressed used for the alerts, requires at munimum SMTP_HOST
to be set.
ALERT_RECIPIENT
ALERT_SENDER
The port is always optional, default is 4949
NODES
format:name1:ip1[:port1] name2:ip2[:port2] …
SNMP_NODES
format:name1:ip1[:port1]
…SSH_NODES
format:name1:ip1[:port1]
…
Container is listening on the port 8080
For a bit of persistency
- /var/log/munin -> logs
- /var/lib/munin -> db
- /var/cache/munin -> file deserved by HTTP
docker run -d \
-p 8080:80 \
-v /var/log/munin:/var/log/munin \
-v /var/lib/munin:/var/lib/munin \
-v /var/cache/munin:/var/cache/munin \
-e MUNIN_USERS='username1 username2' \
-e MUNIN_PASSWORDS='passwordi1 password2' \
-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 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" \
lpsrocks/munin-server
You can now reach your munin-server on port 8080 of your host. It will display an error until munin is run for the first time.
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.