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 - v3 Compatibility With Previous Versions
Viewed 26714 times since Fri, Jun 24, 2016
NRPE - Turn Off XINETD Logging On Success
Viewed 7715 times since Tue, Mar 7, 2017
NRPE - Error While Loading Shared Libraries: libssl.so
Viewed 5561 times since Mon, Jul 17, 2017
NRPE - NRPE: Unable To Read Output
Viewed 47492 times since Mon, Jul 17, 2017
NRPE - Linux Cached Memory Not Added to Free Memory
Viewed 5408 times since Wed, Jan 27, 2016
Nagios XI - Problems with $ Signs in the Check Command
Viewed 4277 times since Tue, Jan 26, 2016
NRPE - CHECK_NRPE: Socket Timeout After n Seconds
Viewed 56336 times since Sun, Jul 16, 2017
NRPE - Return Code Of 127 Is Out Of Bounds - Plugin May Be Missing
Viewed 13390 times since Fri, Jul 14, 2017
Disabling Port 113 IDENT Requests
Viewed 2836 times since Tue, Mar 12, 2019
NRPE - CHECK_NRPE: Error Receiving Data From Daemon
Viewed 6897 times since Mon, Jul 17, 2017