Skip to content

Latest commit

 

History

History
95 lines (59 loc) · 2.63 KB

README.md

File metadata and controls

95 lines (59 loc) · 2.63 KB

munin-server

Multi architecture container image for Munin server using official Alpine image.

  • rrdcached is used to be able to handle a large number of hosts

  • fcgi is used for generation of graphs on demand and not cron

Inspired from build-failures docker-munin-server. Forked from aheimsbakk/munin

Docker Pulls GitHub Workflow Status Docker Image Size (tag)

Tags

Environment variables

  • NODES

    Format [group1;]node1:ip1[:port1] [group2;]node2:ip2[:port2]...

  • SNMP_NODES

    Format [group1;]node1:commutiy1: [group2;]node2:community2:...

    Check SNMP units directly from the container. Defaults to SNMP version 2c.

  • TZ

    Time zone. Defaults to UTC.

Exposed ports

  • 80

Volumes

For persistense.

  • /etc/munin/munin-conf.d/

    Configuration files included on runtime. The files nodes.conf and smtp-nodes.conf are generated by this container.

  • /etc/munin/plugin-conf.d/

    Configuration files for plugins. The file snmp_communities is generated by this container, but custom changes will not be overwritten.

  • /var/lib/munin/

    All RRD files and temporary files.

  • /var/log/munin/

    Log files.

How to use this container

docker run -d \
  -v /etc/munin/munin-conf.d:/etc/munin/munin-conf.d \
  -v /etc/munin/plugin-conf.d:/etc/munin/plugin-conf.d \
  -v /var/lib/munin:/var/lib/munin \
  -v /var/log/munin:/var/log/munin \
  -e NODES="server1:10.0.0.2 server2:10.1.0.2" \
  -e SNMP_NODES="routers;10.0.0.1:mycommunity routers;10.1.0.1:mycommunity" \
  -p 80:80 \
  --name munin-server \
  kdcio/munin-server

Using docker-compose.yml

version: '2.4'

services:
  munin:
    image: kdcio/munin-server
    volumes:
      - /etc/munin/munin/munin-conf.d:/etc/munin/munin-conf.d 
      - /etc/munin/munin/plugin-conf.d:/etc/munin/plugin-conf.d
      - /var/lib/munin:/var/lib/munin 
      - /var/log/munin:/var/log/munin
    environment: 
      NODES: routers;10.0.0.1:mycommunity routers;10.1.0.1:mycommunity
    ports:
      - 80:80

Access container at http://host/munin/