Linux

Where Does Icinga 2 Store Config and State?

Icinga 2 reads objects from /etc/icinga2 with runtime state in /var/lib/icinga2 beside logs.

Last updated

Icinga 2 configures from files in /etc/icinga2. The icinga2.conf file includes zones and features while conf.d holds host and service objects. The API and IDO database settings live in features folders.

Runtime state lands in /var/lib/icinga2 with retention and cluster sync files. Validate every edit with the daemon check flag before reload. Keep custom objects out of shipped conf.d examples.

Where Icinga stores this, by platform

Linux
/etc/icinga2/icinga2.conf

Includes for zones, features, and conf.d objects live here. Runtime state sits in /var/lib/icinga2. Validate with daemon check before reload.

Frequently asked questions

Where do I add a monitored host?

In a conf.d object file with host and service definitions, then validate and reload. Templates keep blocks short. The web UI picks it up after reload.

Where is the Icinga 2 state?

In /var/lib/icinga2 with retention and API files. Database history flows to the IDO backend separately. Copy state with the daemon stopped.

Notice an outdated path? Let us know.