Unraid Node Exporter

An Unraid Community Apps Docker template for the official Prometheus node_exporter distroless image. This is a Docker app template, not an Unraid .plg plugin.

Metrics

node_exporter exposes generic Linux host metrics for CPU, memory, filesystems, disks, networking, the kernel, and hardware sensors:

http://UNRAID-IP:9100/metrics

It does not expose Unraid-specific state such as share configuration, mover activity, detailed parity operations, or every status available through emhttp. Those require a separate Unraid-specific exporter.

Runtime And Security

• Host networking and the host PID namespace provide an accurate view of the Unraid host.
• The host root is mounted read-only with recursive-slave propagation so newly attached array, pool, and Unassigned Devices mounts become visible.
• The official distroless image runs as a non-root user without privileged mode or additional capabilities.
• The read-only host mount prevents writes but may expose readable host files to the container.
• Host TCP port 9100 must be available. Metrics stop when Docker is stopped.
• The distroless image has no shell, so Unraid's container console is unavailable. Use container logs and the metrics endpoint for diagnostics.

Optional Root-Only Metrics

The non-root default can omit RAPL energy metrics and detailed Btrfs metrics for restricted mounts such as /var/lib/docker. To enable them, append --user=0 to Extra Parameters while preserving the existing option:

--pid=host --user=0

The host mount remains read-only, but node_exporter can then read root-only host files. Enable this only when those additional metrics justify the access.

Installation

Install Node Exporter from Community Apps, start the container, and verify the metrics endpoint. Add a scrape job to prometheus.yml:

scrape_configs:
  - job_name: unraid
    static_configs:
      - targets: ["UNRAID-IP:9100"]

Maintainers should follow TESTING.md before publishing a new template version.

Support

Report problems or request changes through GitHub Issues.

License And Trademark

The original template and documentation are MIT licensed. node_exporter and its container image are separate upstream works licensed under Apache-2.0.

Prometheus is a trademark of The Linux Foundation. The official Prometheus logo is used to identify Prometheus node_exporter. This independently maintained Unraid template is not endorsed by or affiliated with The Linux Foundation or the Prometheus project.