Implements #406 by adding a --health CLI flag and HEALTHCHECK instruction
to the Dockerfile. This allows Docker and container orchestration platforms
to monitor container health automatically.
Changes:
- Added --health flag that validates configuration and plugin connectivity
- Implemented HealthCheck() method in pkg/poller/commands.go
- Updated Dockerfile with HEALTHCHECK instruction (30s interval, 10s timeout)
- Updated MANUAL.md with --health flag documentation
- Added health check documentation to Docker README
- Added comments to docker-compose examples about built-in health check
The health check:
- Validates configuration file is found and parseable
- Ensures at least one input and one enabled output are configured
- Performs basic validation on enabled outputs
- Returns exit code 0 (healthy) or 1 (unhealthy)
- Runs silently for Docker compatibility
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
InfluxDB 1.8 is the latest 1.x version to support the environment variables specified in the `docker-compose.yml`. If set to `latest` the newer 2.x version of InfluxDB is pulled and the user/db is not initialized.
Variables:
- Removed the `...Rendering_callback_url` references
- Removed the `GRAFANA_NETWORK` variables, as the network name can't be a variable.
Instructions:
- Fixed a few errors
- Added the section for running `docker-compose up -d` to start the containers, and then included creating the influx database instructions utilizing the GUI.
Here are some of the higher-level, more basic updates that you guys mentioned so far:
- Added a small part about the `.env` file and what its for
- Changed the various references to directories from `grafana` to `unifi-poller` as the base
- Changed the user name to create in the GUI from `grafana` to `unifi-poller`.
- Thought this might be more streamlined(?)
- Might want to look into changing that on the docker instructions, too, if we prefer this
- You have to keep the `sudo id` bit later, as we can't tell the GUI to use a specific user ID.
Let me know what you think about these minor updates, here.
This is the first push with most of the edits/variables in place. Most of whats left is filling out the `README.md` file for the variables and what they mean and/or need.
- Moved most of the editable/user configurable options to variables inside of the `docker-compose.example.env` file
- Wrote the explainer for the directory creation and the user creation that is necessary
Cody Lee
Cody Lee
David Newhall
Doug Rabson
crustulumtheoneandonly
John Warne
Justin Partain
David Lee
L2v2P
Matthww
Jon Bloom