Notifications
Runner sends email to your account address for events that affect your account, your project memberships, your access tokens, and the runs you care about. All emails require SMTP to be configured in Settings — if email is not set up, nothing is sent.
Email sender
Every email Runner sends uses the sender name and sender email address configured in Settings. These appear in the From field. If no sender name is configured, only the email address is shown. Contact your Admin if you are not receiving emails or want to verify the configured sender.
Email headers
Runner sets custom headers on every notification email. Most mail clients — Gmail, Apple Mail, Thunderbird, and others — support filter rules based on custom headers, even if they are not visible by default. Use these to route Runner notifications into folders or apply labels automatically.
| Header | Always present | Value |
|---|---|---|
X-NodePit-Runner-Notification-Reason | ✓ | The notification type, e.g. run-status, member-added, user-access-token-expiring-soon. |
X-NodePit-Runner-Project-Id | The ID of the related project. Set on run, schedule, environment, and membership notifications. | |
X-NodePit-Runner-Environment-Id | The ID of the related environment. Set on run notifications. | |
X-NodePit-Runner-Schedule-Id | The ID of the related schedule. Set on run notifications. | |
X-NodePit-Runner-Run-Id | The ID of the run. Set on run notifications. | |
X-NodePit-Runner-Run-State | The run's outcome: passed, failed, or canceled. Set on run notifications. |
A typical setup is a filter that moves all messages where X-NodePit-Runner-Notification-Reason is run-status to a dedicated folder, or one that separates notifications per project using X-NodePit-Runner-Project-Id.
Run notifications
Run notifications are the only emails you can configure yourself. They are set per schedule in the schedule's Notifications card — you choose which outcomes trigger an email: passed, failed, or canceled. See Schedules for details.
Account, membership, and token emails
Runner sends automatic notifications for account events (registration, confirmation, password and email address changes), project membership changes (added, role changed, removed), and access token activity (created, deleted, expiring soon, expired). These emails cannot be disabled. They serve as security notices — if you receive one you did not expect, contact your Admin.