mirror of
https://github.com/unpoller/unpoller.git
synced 2026-10-17 20:03:53 +02:00
Cody LeeandCursor
9bc7f2c5bf
Add v3 integration and version tests, migration notes, InfluxDB 3 docker-compose stack, and README updates to finish the remaining plan phases. Co-authored-by: Cursor <cursoragent@cursor.com>
36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
## Docker Compose
|
|
|
|
The files in this folder can be used locally to spin up
|
|
a full set of applications (minus the UniFi controller) to get
|
|
UniFi Poller up and running. Including InfluxDB, Grafana, and
|
|
Chronograph. This last app is useful to inspect the data stored
|
|
in InfluxDB by UniFi Poller.
|
|
|
|
##### HOWTO
|
|
**Learn more about how and when to use these *Docker Compose* files in the
|
|
[Docker Wiki](https://unpoller.com/docs/install/dockercompose).**
|
|
|
|
## Health Check
|
|
|
|
The UniFi Poller Docker image includes a built-in health check that validates
|
|
the configuration and checks plugin connectivity. The health check runs every
|
|
30 seconds and marks the container as unhealthy if configuration issues are
|
|
detected or if enabled outputs cannot be reached.
|
|
|
|
You can manually run the health check:
|
|
```bash
|
|
docker exec <container_name> /usr/bin/unpoller --health
|
|
```
|
|
|
|
The health check is automatically used by Docker and container orchestration
|
|
platforms (Kubernetes, Docker Swarm, etc.) to determine container health status.
|
|
|
|
## InfluxDB 3 Core
|
|
|
|
Use `docker-compose-influxdb3.yml` with `docker-compose-influxdb3.env.example` to run UniFi Poller against InfluxDB 3 Core on port `8181`. Copy the env example, set `INFLUXDB_ADMIN_TOKEN` to a token created in InfluxDB 3, then start the stack:
|
|
|
|
```bash
|
|
cp docker-compose-influxdb3.env.example docker-compose-influxdb3.env
|
|
docker compose -f docker-compose-influxdb3.yml --env-file docker-compose-influxdb3.env up -d
|
|
```
|