icinga2/README.md

Docker Icinga2

If you need a full stack:

• AO-IT: icinga-stack
  • AO-IT: icingaweb2

Or a additional satellite:

• AO-IT: icinga-satellite

usage

git clone https://git.ao-it.net/docker/icinga2
cd icinga2
cp env.sample .env
nano .env   # set your env
docker compose up

Default vars a working but not recommend in prod!
Minimum recommended adjustments:

• ICINGA2_API_USER_ROOT_PASS
• ICINGA2_API_USER_ICINGAWEB_PASS

All other var can be use at is, because all is in docker network and not exposed.

Hints:

• API user setup only runs once at start up!
• Redis conf runs every time

vars

var	description	note
ICINGA2_API_USER_ROOT_PASS	replace root API user randome password with this	only on first setup
ICINGA2_API_USER_ICINGAWEB_PASS	create API user icingadb with this password	only on first setup, if not set user will not create
ICINGA2_API_USER_SATELLITE_PASS	create API user pki-ticket with this password	only on first setup, if not set user will not create
ICINGA2_ICINGADB_REDIS_HOST	set redis db host	can set by every startup
ICINGA2_ICINGADB_REDIS_PORT	set redis db port	can set by every startup
ICINGA2_ICINGADB_REDIS_PASS	set redis db password	usually not required can set by every startup
ICINGA2_INFLUXDB_HOST	set influx db host	can set by every startup
ICINGA2_INFLUXDB_PORT	set influx db port	can set by every startup
ICINGA2_INFLUXDB_DB	set influx db name	can set by every startup