Welcome to the GenMaster User Manual¶
This manual walks through every screen and option in the GenMaster web interface — the master controller for your distributed generator control system. Use it as a reference to find what a button does, what a status panel is telling you, or how to configure a particular feature.
How this manual is organized¶
Each top-level navigation tab in GenMaster has its own page in this manual:
| Page | What it covers |
|---|---|
| Generator Control | The home page — start/stop, arming, fuel tracking, runtime limits, exercise schedule, generator info |
| GenSlave | Remote relay controller status — health, network, failsafe, notifications, scheduled reboot |
| Schedule | Creating and managing scheduled runs |
| Run History | Browsing past runs with filters |
| Notifications | Apprise channels and groups, configure rules, history |
| Containers | Docker container management |
| System | Host health, network, terminal, SSL certs, WiFi watchdog |
| Settings | Appearance, security, access control, environment, account, advanced |
| Common UI | Theme toggle, Help dialog, About dialog, login/logout |
| Appendix | Troubleshooting, glossary, security flag index |
Layout overview¶
Every GenMaster page shares the same top header and main content area.

From left to right in the header you'll find:
- GenMaster wordmark — links back to the home page (Generator Control)
- Top navigation — one tab per major area: Generator, GenSlave, Schedule, History, Notifications, Containers, System, Settings
- Help & Documentation (?) — opens the in-app help dialog with links to this manual and the GitHub repo
- About (i) — shows version and build info
- Theme toggle (sun/moon) — switches between light and dark mode
- User badge — shows the logged-in user (default:
admin) - Logout (door icon) — ends the current session
The top navigation is sticky: it stays visible as you scroll down any page.
Reading conventions¶
This manual uses a few visual cues:
Note
A clarification or extra detail.
Tip
A best practice or shortcut worth remembering.
Warning
Something that can affect operation if ignored.
Danger
Destructive action — read carefully before proceeding.
Sensitive data
Indicates a screenshot contains data you may want to mask before publishing or sharing externally (IPs, hostnames, tokens).
What you need to use GenMaster¶
- A browser pointed at your GenMaster instance (typically
https://<your-domain>orhttps://<tailscale-host>) - An admin account (default username
admin, set the password during setup) - A connected GenSlave on the same network (or via Tailscale) for the generator relay to function
If GenMaster reports the slave as offline, see GenSlave and the Appendix troubleshooting tables.
Where to start¶
If you're new to GenMaster, read the pages in nav order — they progress from the most-used screen (Generator Control) to the least-used (Settings → Advanced). If you're looking up a specific feature, the per-page table of contents on the right side of each page makes it easy to jump straight to the section you need.