v0.1.0

Email Alert Setup

Last updated


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)


  1. smtp host smtp.gmail.com
  2. smtp port 587
  3. smtp username your@gmail.com
  4. smtp password abcdefghijklmnop
  5. smtp from your@gmail.com
  6. smtp add ops@example.com
  7. smtp add oncall@example.com
  8. smtp enabled true
  9. test

Each command writes to .webMonitor.json immediately; no restart is needed.

Input Rules


RuleDescription
Whitespace-separatedCommands split with strings.Fields, and each value takes only the first token
Values cannot contain spacesGmail shows app passwords as four groups of four characters; remove the spaces when entering them
port must be an integerNon-integer values are rejected
enabledtrue or 1 enables; any other value disables
Recipient dedupsmtp 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:
FieldDisplay
Host / Username / Fromunset when empty
PasswordMasked with the same number of *
ToAll recipients joined with commas
CCunset when empty
EnabledGreen Enable / red Disable

Type back or press <kbd>Esc</kbd> 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


  1. smtp enabled false

Once disabled, neither alerts nor test send email; the other settings are kept.
See SMTP Connection for how each port connects.
中文