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 - Error While Loading Shared Libraries: libssl.so
Viewed 7242 times since Mon, Jul 17, 2017
Nagios XI - Problems with $ Signs in the Check Command
Viewed 5565 times since Tue, Jan 26, 2016
NRPE - Command ’[Your Plugin]’ Not Defined
Viewed 6115 times since Mon, Jul 17, 2017
NRPE - No Output Returned From Plugin
Viewed 12289 times since Mon, Jul 17, 2017
NRPE - CHECK_NRPE: Socket Timeout After n Seconds
Viewed 70921 times since Sun, Jul 16, 2017
NRPE - Agent and Plugin Explained
Viewed 45740 times since Fri, Jul 14, 2017
How To Clear Solaris Service Maintenance Status
Viewed 21693 times since Mon, Mar 6, 2017
NRPE - Remote does not support Version 3 Packets
Viewed 18567 times since Mon, Nov 27, 2017
NRPE - Turn Off XINETD Logging On Success
Viewed 9670 times since Tue, Mar 7, 2017
NRPE - v3/v4 Compatibility With Previous Versions
Viewed 32588 times since Fri, Jun 24, 2016