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 - Packet Size Explained
Viewed 1316 times since Thu, Jun 30, 2016
NRPE - Agent and Plugin Explained
Viewed 5980 times since Fri, Jul 14, 2017
NRPE - Linux Cached Memory Not Added to Free Memory
Viewed 788 times since Wed, Jan 27, 2016
How To Clear Solaris Service Maintenance Status
Viewed 2202 times since Mon, Mar 6, 2017
NRPE - CHECK_NRPE: Socket Timeout After n Seconds
Viewed 8982 times since Sun, Jul 16, 2017
NRPE - CHECK_NRPE: Received 0 Bytes From Daemon. Check The Remote Server Logs For Error Messages
Viewed 872 times since Mon, Jul 17, 2017
NRPE - Command ’[Your Plugin]’ Not Defined
Viewed 757 times since Mon, Jul 17, 2017
NRPE - v3 Compatibility With Previous Versions
Viewed 3513 times since Fri, Jun 24, 2016
NRPE - Return Code Of 127 Is Out Of Bounds - Plugin May Be Missing
Viewed 1554 times since Fri, Jul 14, 2017
NRPE - Remote does not support Version 3 Packets
Viewed 1973 times since Mon, Nov 27, 2017