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
