Nut-influxdbv2-exporter

A Docker-based exporter that pushes power metrics from a NUT (Network UPS Tools) server into InfluxDB v2.

  • Home Automation
  • Monitoring & Logging
  • Tools & Utilities
A Docker-based exporter that pushes power metrics from a NUT (Network UPS Tools) server into InfluxDB v2. It queries your UPS and writes the readings to a configured InfluxDB bucket, so homelabbers can track power and battery stats over time in dashboards like Grafana.

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

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

Collected 53 days ago - public community threads