SSH Mode
SSH mode wraps the full Herald TUI in a Charm Wish SSH server. Each SSH session can either open its own local backend connection or connect to a running Herald daemon.
Build and Run
Section titled “Build and Run”go build -o bin/herald-ssh-server ./cmd/herald-ssh-server./bin/herald-ssh-server -config ~/.herald/conf.yaml -addr :2222Connect from another terminal:
ssh -p 2222 localhostUse a specific host key path:
./bin/herald-ssh-server -host-key .ssh/host_ed25519Use the daemon backend instead of opening IMAP per SSH session:
./bin/herald serve -config ~/.herald/conf.yaml./bin/herald-ssh-server -config ~/.herald/conf.yaml -daemon http://127.0.0.1:7272User-Facing Behavior
Section titled “User-Facing Behavior”The SSH TUI uses the same tabs, keybindings, and overlays as local Herald. The difference is process ownership: without -daemon, each SSH connection creates its own backend and IMAP connection; with -daemon, the session uses the shared remote backend.
Security Notes
Section titled “Security Notes”SSH mode creates or uses an SSH host key path. Bind to a local address or protect network exposure appropriately. Mail credentials still come from the Herald config file on the machine running the SSH server.
Troubleshooting
Section titled “Troubleshooting”If connection fails, verify the server is running and listening on the expected address. If the TUI opens but mail fails, check config path and provider connectivity on the server machine. If daemon mode fails, run ./bin/herald status.