Skip to content

What you need first

Sentinel is infrastructure you deploy, not a plugin you install. Before starting, it is worth knowing exactly what that means, because the setup is four manual stages and none of them can be completed without the accounts below.

What Why What you need in it
A Sentry organization The alerts come from here Permission to create an internal integration, and an org admin token for the alert migration
A Microsoft 365 tenant with Azure The cards are posted here Tenant admin rights, to register an app and create an Azure Bot
An AWS account The receiver runs here Credentials for the region you deploy into, and permission to write SSM parameters and deploy a CDK stack
A GitHub App Only if you want autofix Installed on the repository the fixes will target
Claude Code access The unattended sessions run on it A subscription that can run cloud routines

If any of those five is a blocker, it is a blocker now rather than three stages in.

  • Python 3.12 or newer. The Lambda runs 3.12 and CI covers 3.12 and 3.13.
  • Docker running, for the Lambda bundle. OrbStack is fine.
  • AWS credentials for the target account.
  • Node 22, only if you intend to work on this documentation site.

The stages depend on each other, so run them in this order:

  1. Microsoft setup, which gives the receiver its bot identity.
  2. Sentry setup, which creates the integration that webhooks alerts in.
  3. Configure and deploy, which fills in the config and stands the receiver up.

The two setup stages both write secrets with the same script, so you can run it once with all three values rather than twice.