Network UPS Tools client docker

A containerized Network UPS Tools (NUT) client that monitors a remote UPS server.

Features

• Lightweight Alpine-based container
• Configurable UPS monitoring settings
• Built-in health checks
• Debug shell access
• Automatic shutdown capability

Configuration

Environment Variables

Variable	Default	Description
UPS_HOST	localhost	NUT server hostname
UPS_USER	upsmon	NUT ups monitor username
UPS_PASS	secret	NUT ups monitor password
UPS_NAME	ups	NUT UPS device name
SHUTDOWNCMD	shutdown -h now	Command executed on power failure

Usage

Building the Container

docker build -t nut-client .

Running in Production

docker run -d \
  --name nut-client \
  -e UPS_HOST=pve1.local \
  -e UPS_USER=observer \
  -e UPS_PASS=pass1234 \
  -e UPS_NAME=myups \
  nut-client

Debug Mode

To enter the container with a shell:

docker run -it --rm nut-client shell