Skip to main content

Email/Slack Notifications

If you have installed the Harden-Runner GitHub App (it's a mandatory step for private repositories and optional for public repositories), you can configure Slack and email notifications to receive important CI/CD runtime events in addition to Insights Page and GitHub Actions workflow execution logs.

Harden-Runner is designed to minimize alert fatigue to show each notification only once. If Harden-Runner detects the same anomalous behaviors in future workflow runs, it won't send notifications.

Please note that these notification settings apply to all repositories inside the GitHub organizations.

How to check if the App is installed?

The quickest way to check if the Harden-Runner GitHub App is installed or not is by visiting the notifications settings page. Click on Notification icon next to Recommended Policy header on the Insights page. Harden Runner Notification Settings

You will see the following message if the App is not installed. Please install the GitHub App by following the instructions provided on the page if the app is not installed. Harden Runner App Not Installed

If the App is installed, then you would see notification settings on the page.

Email Notifications

You can provide an email address on the notifications settings page to receive notification emails. Please enter your monitoring email address in Email textbox, choose appropriate events from Notification Events section, and click on Save button. Email Notification Setup

Once email notification settings are updated, you will receive notification emails from Here is a sample notification email: Sample Notification Email

Slack Notifications

Similar to email notifications, you can setup Slack notifications on the notification settings page by providing a Slack Webhook. Please follow these instructions to create a Slack Webhook. Once you have a webhook, update appropriate notification settings. Slack Notification Setup

Here is a sample Slack notification: Sample Notification Slack