MUNIN-RUN(1p)

💖 MUNIN-RUN 💖

okay bestie, welcome to munin-run — it's a page from the User Contributed Perl Documentation (section 1p, for the record 👑), and it's literally the little command-line bestie that runs your Munin plugins for you. let's get into it 🫶

---

✨ NAME ✨

munin-run — a program to run Munin plugins from the command line 💅

---

🌸 SYNOPSIS 🌸

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

---

🦋 DESCRIPTION 🦋

so munin-run is a script that runs Munin plugins straight from the command-line. it's so useful when you're debugging plugins, because it runs them in the exact same conditions as they get run under munin-node. same vibe, same energy, no surprises 💖

---

🎀 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 permissions. default is [disabled]
• --ignore-systemd-properties — don't try to detect and enforce the locally configured hardening flags of the munin-node service unit. this detection is skipped anyway if systemd isn't enabled. ngl those hardening flags can cause subtile surprises 🙈 — for example, ProtectHome=yes stops the df plugin from figuring out the state of the home partition. default is [disabled]
• --help — view this help message 👀
• --debug — print debug messages. debug messages go to STDOUT and are 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 plugins can enable debugging. default is [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 like… that can cause surprising differences between what munin-run gives you and what the real munin-node service gives you 😭

a popular example of this kind of surprising restriction is ProtectHome=yes combined with the df plugin. the restriction silently stops the plugin from determining the status of mountpoints below /home. like it just won't tell you. rude.

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 wanna debug potential issues with systemd restrictions, you may wanna use the parameters --ignore-systemd-properties and --debug. permanent overrides of systemd properties can be configured locally via:

systemctl edit munin-node

and 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.76 🎉

---

👑 AUTHORS 👑

Audun Ytterdal, Jimmy Olsen, Tore Anderson, Nicolai Langfeldt, Lars Kruse. legends, honestly 🫶

---

🌈 COPYRIGHT 🌈

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.

---

ngl bestie, that's the whole page 💖 go debug something and slay 💅

okay that's a wrap!! this was perl v5.40.1, dated 2025-05-20 — munin-run page, out 🎀✨