Home » Categories » Multiple Categories

NRPE - UNKNOWN: No Handler For That Command

Problem Description

This KB article addresses the following NRPE error or variants of this error:

UNKNOWN: No Handler For That Command
No handler for command:
Unknown command(s):


Assumed Knowledge

The following KB article contains an explanation of how NRPE works and may need to be referenced to completely understand the problem and solution that is provided here:

NRPE - Agent and Plugin Explained

In addition to this, NSClient++ must be correctly installed and configured, please refer to the following KB article on enabling the NRPE listener in NSClient++:

Documentation - Enabling The NRPE Listener In NSClient++ 0.4.x


Troubleshooting The Error

This is usually caused by a missing or incorrectly spelled handler (external alias) in the remote host's C:\Program Files\NSClient++\nsclient.ini file.

Check the spelling of the check_nrpe command for the service check in Nagios XI (the name of the command after the "-c").  It should match the spelling of the external alias in the nsclient config file.  For example:

[/settings/external scripts/alias]
alias_cpu = checkCPU warn=80 crit=90 time=5m time=1m time=30s


In the example above, the "alias_cpu" is the handler and therefore the service check in Nagios XI should specify the check_nrpe command as "alias_cpu".



Final Thoughts

For any support related questions please visit the Nagios Support Forums at:


2.5 (2)
Article Rating (2 Votes)
Rate this article
  • Icon PDFExport to PDF
  • Icon MS-WordExport to MS Word
Attachments Attachments
There are no attachments for this article.
Related Articles RSS Feed
NRPE - Connection Refused By Host
Viewed 7737 times since Mon, Jul 17, 2017
NRPE - Return Code Of 126 Is Out Of Bounds - Plugin May Not Be Executable
Viewed 2726 times since Fri, Jul 14, 2017
How To Clear Solaris Service Maintenance Status
Viewed 11132 times since Mon, Mar 6, 2017
NRPE - Error While Loading Shared Libraries: libssl.so
Viewed 3535 times since Mon, Jul 17, 2017
NRPE - Command ’[Your Plugin]’ Not Defined
Viewed 2978 times since Mon, Jul 17, 2017
NRPE - General Troubleshooting Tips
Viewed 5917 times since Mon, Jul 17, 2017
NRPE - Linux Cached Memory Not Added to Free Memory
Viewed 3169 times since Wed, Jan 27, 2016
NRPE - ERROR: Missing Argument Exception
Viewed 1787 times since Mon, Jul 17, 2017
NRPE - v3 Compatibility With Previous Versions
Viewed 15883 times since Fri, Jun 24, 2016
NRPE - NRPE: Unable To Read Output
Viewed 29738 times since Mon, Jul 17, 2017