MUNIN-RUN(1)

📦
version 2.0.78 · 8 versions
, in fedora 43, fedora 44

✨ munin-run — the little command-line bestie for your Munin plugins ✨

User Contributed Perl Documentation 💖 (yes, it's a Perl script, we love her for that)

🌸 NAME 🌸

munin-run — a program that runs Munin plugins straight from the command line. slay

🎀 SYNOPSIS 🎀

munin-run [options] <plugin> [ config | autoconf | snmpconf | suggest ]

🦋 DESCRIPTION 🦋

Okay so bestie, munin-run is a script that runs Munin plugins from the command line. It's literally the plug for debugging your plugins, because it runs them in the exact same conditions as they get run under munin-node. Same vibes, same environment, no cap. 👑

💅 OPTIONS 💅

  • --config <configfile> — use file as the configuration file. Default is /etc/munin/munin-node.conf. 🍓
  • --servicedir <dir> — use dir as the plugin dir. Default is /etc/munin/plugins/. ✨
  • --sconfdir <dir> — use dir as the plugin configuration dir. Default is /etc/munin/plugin-conf.d/. 🎀
  • --sconffile <file> — use file as the plugin configuration. This one overrides sconfdir. Default is undefined. 💀
  • --paranoia — only run plugins that are owned by root, and check the permissions too. Default: disabled. 🙈
  • --ignore-systemd-properties — do not try to detect and enforce the locally configured hardening flags of the munin-node service unit. This detection gets skipped if systemd isn't enabled. Those hardening flags can cause some sneaky little surprises — for example ProtectHome=yes stops the df plugin from figuring out the state of the home partition. Default: disabled. 😭
  • --help — view this help message. 🫶
  • --debug — print debug messages. Debug messages go to STDOUT and get prefixed with # (this makes it easier for other parts of munin to use munin-run and still have --debug turned on). Only errors go to STDERR. 🔥
  • --pidebug — plugin debug. Sets the environment variable MUNIN_DEBUG to 1 so that plugins may enable debugging. Default: disabled. 🌈
  • --version — show version information. ⭐

🌟 NOTES FOR SYSTEMD USERS 🌟

The munin-node service is usually started by systemd via a munin-node.service definition. Some distributions turn on hardening settings in this service file to restrict the allowed set of activities for the munin-node process. And that, bestie, may cause surprising differences between what munin-run gives you and what the real munin-node service gives you. 💀

A popular example of such a surprising restriction is ProtectHome=yes combined with the df plugin. The restriction silently prevents the plugin from determining the status of mountpoints below /home. Not it being quiet about it. 🫠

munin-run tries to mimic this behavior of munin-node automatically. So running munin-run df should give you the same output as:

echo fetch df | nc localhost munin

If you want to debug potential issues caused by systemd restrictions, then you may want to use the parameters --ignore-systemd-properties and --debug. Permanent overrides of systemd properties can be configured locally via systemctl edit munin-node. See man systemd.exec for the documentation of systemd's properties. 🧚

📁 FILES 📁

/etc/munin/munin-node.conf
/etc/munin/plugins/*
/etc/munin/plugin-conf.d/*
/var/run/munin/munin-node.pid
/var/log/munin/munin-node.log

👑 VERSION 👑

This is munin-run (munin-node) v2.0.78. 💖

🌸 AUTHORS 🌸

Audun Ytterdal, Jimmy Olsen, Tore Anderson, Nicolai Langfeldt, Lars Kruse. icons, all of them 👑

Copyright (C) 2002-2009 Audun Ytterdal, Jimmy Olsen, Tore Anderson, Nicolai Langfeldt / Linpro AS. Copyright (C) 2020 Lars Kruse

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 dated June, 1991.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

and that's the whole page, bestie — go debug something gorgeous 💅

perl v5.42.3 · 2026-09-30 · MUNIN-RUN(1) — mwah, see u next manpage 💖✨

📦 where this page comes from