Install on Windows
Deploy MayaUPS as a Windows service through SCM or with the MSI installer. The application embeds the web UI and SQLite database, so it does not require a separate virtual appliance or hosted service. [[TODO: publish the signed installer filename and checksum]]
Install on Linux
Run MayaUPS as a systemd service with sudo mayaups -install-service, or deploy it with Docker on Linux. An optional host agent supports ordered shutdown work. [[TODO: publish the final Docker image or package path]]
First run
The first-run admin password is shown once. Roles are viewer, operator, and admin, which gives a simple separation between read-only review, day-to-day operation, and administrative change. Daily backups, restore, disk-space guard, graceful stop, optional file logging, and the internal watchdog belong in the operational checklist.
Try the demo
Run mayaups.exe -demo to seed 12 simulated UPS across 3 sites with 7 days of history, alarms, and reports. The demo lets a reviewer inspect fleet health, readable alarm states, history charts, battery planning, service records, and budget views before connecting production hardware.
Onboard devices
Use CSV import with a template and dry-run preview, Test connection per device, or gentle read-only discovery initiated by the operator. SNMPv3 discovery uses authentication and privacy credentials, and discovery is bounded to a /24 rather than running automatically across the network.
Connect a UPS without a network card
Install the optional MayaUPS agent on a Windows or Linux host and select its USB-HID or serial source. Direct-attach support uses documented decoding and fixtures; real model and cable validation remains part of commissioning.
Prove shutdown before arming it
Shutdown policy starts in Observe, moves through Dry-run proof, and only then becomes Armed. Runtime and event triggers may drive guarded SNMP-SET UPS shutdown and ordered host shutdown through the mTLS agent, so the dry run must pass before arming. Live Linux host shutdown remains under bench confirmation.