Email Alert Setup
This page shows how to configure SMTP inside the TUI with smtp commands, manage recipients, and send a test email.
Setup Steps (Gmail, 587 STARTTLS)
smtp host smtp.gmail.com
smtp port 587
smtp username your@gmail.com
smtp password abcdefghijklmnop
smtp from your@gmail.com
smtp add ops@example.com
smtp add oncall@example.com
smtp enabled true
test
Each command writes to .webMonitor.json immediately; no restart is needed.
Input Rules
| Rule | Description |
|---|---|
| Whitespace-separated | Commands split with strings.Fields, and each value takes only the first token |
| Values cannot contain spaces | Gmail shows app passwords as four groups of four characters; remove the spaces when entering them |
port must be an integer |
Non-integer values are rejected |
enabled |
true or 1 enables; any other value disables |
| Recipient dedup | smtp add ignores an address that already exists |
View the Settings
Type smtp (or smtp show) to switch to the SMTP view, where the System panel shows the current settings:
| Field | Display |
|---|---|
| Host / Username / From | unset when empty |
| Password | Masked with the same number of * |
| To | All recipients joined with commas |
| CC | unset when empty |
| Enabled | Green Enable / red Disable |
Type back or press Esc to return to the main view.
Test Email
test sends an HTML email titled Website Monitoring System - Test in the background. Send errors go only to stderr and never appear in the System panel, so check the inbox to confirm delivery.
CC
The TUI has no command for CC. When you need it, edit config.cc (a single string) in .webMonitor.json after the program exits. When it is empty, the Cc header carries the sender address.
Disable Alerts
smtp enabled false
Once disabled, neither alerts nor test send email; the other settings are kept.
See SMTP Connection for how each port connects.