Nut-influxdbv2-exporter
A Docker-based exporter that pushes power metrics from a NUT (Network UPS Tools) server into InfluxDB v2.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
13/100 Low
- Maintained
- 0last commit 1303 days ago
- Popular
- 165 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 33 days ago
- GitHub stars
- 5
- Open issues
- 0
- Last commit
- 2023-04-27
- License
- MPL-2.0
- Activity
- stale
Checked 9 days ago - source: GitHub (jwillmer/nut-influxdbv2)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Install Node.js 22 and nut.js Make sure Node.js 22.x or later (the program that runs these JavaScript tools) is installed, then run npm install @nut-tree/nut-js in your project folder. Without the right Node.js version and the core package, the automation code will not start or run correctly. source
- Check private registry access Run npm whoami --registry=https://pkg.nutjs.dev and make sure it returns the ID for your access token (a password-like code). If it does not, npm may not be able to download the needed Nut.js packages from the private registry. source
- Run a quick mouse test Create and run the small test script that prints mouse position, and install tsx (a helper that runs TypeScript) if you do not already have it. This catches missing permissions or broken setup early, before real automation acts on your screen. source
- Environment variables Set INFLUXDB2_TOKEN to your InfluxDB v2 API token; INFLUXDB2_HOST, PORT, ORG, and BUCKET default to localhost:8086 / Home / DEV if suitable. source
Fetched 45 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Which environment variables must I set for the container?
INFLUXDB2_TOKEN is required, and WATTS is required only if the UPS does not report ups.realpower.nominal. The other variables have default values.
How do I configure the container for an HTTPS InfluxDB endpoint?
Use INFLUXDB2_SSL and INFLUXDB2_SSL_VERIFY to match your InfluxDB TLS setup, since the defaults assume HTTP and invalid certificates can cause errors.
Why might Grafana show errors even when the exporter is running?
Check that the dashboard panels use InfluxDB 2 Flux queries instead of InfluxDB v1 queries, because some dashboards can be based on the older query language.
Which Grafana dashboard is specifically for this exporter?
Dashboard 20077 is described as a NUT UPS InfluxDBv2 dashboard for data exported by nut-influxdbv2.
Answers sourced from forums.unraid.net, github.com, grafana.com
Community
- Get UPS info from NUT into Grafana : r/homelab - Reddit (reddit)
- Exporting /monitoring UPS nut server stats to grafana? - Reddit (reddit)
- [SUPPORT] - NUT InfluxDBv2 Exporter - Docker Containers - Unraid (forum)
- Unraid and UPS long term stats : r/unRAID - Reddit (reddit)
- InfluxDB 2 - InfluxData Community Forums (other)
- Export influxdb v2 data - InfluxData Community Forums (other)
Collected 53 days ago - public community threads