Files
icinga2/README.md
anima 04ff12a14f
All checks were successful
build container icinga2 / build (push) Successful in 2m42s
add option for ticket api user
2025-02-02 20:18:03 +01:00

42 lines
1.8 KiB
Markdown

# Docker Icinga2
[![Build Status](https://git.ao-it.net/docker/icinga2/actions/workflows/docker-build.yml/badge.svg?branch=main&event=push)](https://git.ao-it.net/docker/icinga2/actions?workflow=docker-build.yml&actor=0&status=0)
If you need a full stack:
* [AO-IT: icinga-stack](https://git.ao-it.net/docker/icinga-stack)
* [AO-IT: icingaweb2](https://git.ao-it.net/docker/icingaweb2)
Or a additional satellite:
* [AO-IT: icinga-satellite](https://git.ao-it.net/docker/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