LumenTrace is a smart tool designed to monitor UPS (Uninterruptible Power Supply) status and manage Wake-on-LAN (WOL) for your devices during power outages. With a clean, modern web interface, it provides real-time visibility into essential UPS metrics like battery level and load, and lets you configure devices to automatically power back on when electricity is restored.

LumenTrace goes beyond simple WOL automation. It intelligently tracks which devices were online at the time of the outage and retains this data—even if the LumenTrace host itself loses power and reboots. Once power is restored and all monitored UPS units are back online with batteries charged to your defined threshold (default: 80%), LumenTrace automatically sends WOL packets to bring those devices back up. This ensures a smooth and reliable recovery after power loss, regardless of whether the LumenTrace system remained powered throughout the event.

Inspired by the original wolnut project.

services:
  lumentrace:
    image: pwsmith1988/lumentrace:latest
    container_name: lumentrace
    restart: unless-stopped
    environment:
      - TZ=America/New_York  # Replace with your timezone
    cap_add:
      - NET_RAW
      - NET_ADMIN
      - NET_BROADCAST
    network_mode: host
    volumes:
      - ./data:/data
    env_file: .env

volumes:
  lumentrace-data:

SECRET_KEY=YOURSECRETKEYHERE          #place your generated secrect key here

docker compose up -d

Once the container is running, all configuration is managed through the web interface. Follow these steps to get started:

Open your browser and navigate to http://your-host-ip:5000.

In the sidebar, click on the Settings icon.

Enter the required details for your setup, including the NUT Server IP Address and UPS Name. Adjust any other settings as needed.

Click the "Save Settings" button. The application will immediately begin monitoring your UPS with the new configuration.

Return to the Dashboard and begin adding the devices you wish to manage.