Scroll to navigation

ICINGA2(8) System Manager's Manual ICINGA2(8)


icinga2 - The Icinga 2 network monitoring daemon


icinga2 command [ command options ][ global options ]

command := [ api | ca | console | daemon | feature | node | object | pki | variable ] --help


Icinga 2 is an open source monitoring system which checks the availability of your network resources, notifies users of outages, and generates performance data for reporting.

Scalable and extensible, Icinga 2 can monitor large, complex environments across multiple locations.


Details for specific command options can be viewed by invoking the command name with --help parameter.

Global options

Show this help message.
Show version information.
Use VT100 color codes even when stdout is not a terminal.
Define a constant.
Load a library.
Add include search directory.
Specify the log level for the console log, default is information.
Enables the script debugger. When an exception occurs or the 'debugger' keyword is encountered in a user script Icinga 2 launches the script debugger that allows the user to debug the script.

daemon options

The CLI command daemon provides the functionality to start/stop Icinga 2. Furthermore it provides the configuration validation.

Using this option you can specify one or more configuration files. Config files are processed in the order they are specified on the command-line.

When no configuration file is specified and the --no-config is not used, Icinga 2 automatically falls back to using the configuration file ConfigDir + /icinga2.conf (where ConfigDir is usually /etc/icinga2).

Start without a configuration file.
This option can be used to check if your configuration files contain errors. If any errors are found the exit status is 1, otherwise 0 is returned.
Log fatal errors to the specified log file (only works in combination with --daemonize).
Detach from the controlling terminal.


Report bugs at <>
Icinga home page: <>


Copyright © 2012 Icinga GmbH License GPLv2+: GNU GPL version 2 or later <>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

October 2015 icinga2 - The Icinga 2 network monitoring daemon