Munin for Docker

Container image for a Munin master server.

Features ✨

• Provides a Munin master monitoring server
• Displays monitoring graphs through a web interface
• Supports monitoring multiple Munin nodes
• Uses rrdcached for better performance
• Generates graphs on demand with FastCGI
• Supports custom Munin configuration
• Lightweight Alpine-based image

Usage 🐳

Docker Compose:

services:
  munin:
    image: dockurr/munin
    container_name: munin
    environment:
      TZ: "UTC"
      NODES: "server:10.0.0.101,nas:10.0.0.102"
    ports:
      - 80:80
    volumes:
      - ./lib:/var/lib/munin
      - ./log:/var/log/munin
      - ./conf:/etc/munin/munin-conf.d
      - ./plugin:/etc/munin/plugin-conf.d
    restart: always
    stop_grace_period: 1m

Docker CLI:

docker run -it --rm --name munin -p 80:80 -e "NODES=server:10.0.0.101,nas:10.0.0.102" --stop-timeout 60 docker.io/dockurr/munin

Node configuration

Nodes can be configured using the NODES environment variable.

Each node uses the format name:address[:port], where name is a custom label used to identify the node in Munin and address is the hostname or IP address of the machine running munin-node.

For example:

NODES="server:10.0.0.101,nas:10.0.0.102"

Munin uses port 4949 by default. A different port can be specified by adding it after the address:

NODES="server:10.0.0.101:4950"

Existing configuration files in /etc/munin/munin-conf.d are left untouched. This means manually configured nodes, including nodes in an existing nodes.conf, are preserved and can be used alongside nodes supplied through the NODES environment variable.

For more advanced setups, additional Munin configuration can be placed directly in /etc/munin/munin-conf.d.

Acknowledgements 🙏

Special thanks to @aheimsbakk, for creating the original project.

Stars 🌟