Managed SMTP allows Sourcegraph Cloud instances to have email delivery services configured out-of-the-box, and is enabled on all Sourcegraph Cloud instances by default. SMTP services are currently backed by SparkPost EU.

Customer-facing documentation is available here.

In this document:

• Enabling managed SMTP for a Cloud instance - links to guides
• Vendor management - management details for the SMTP vendor
• Monitoring - monitoring SMTP capabilities
• Vendor integration - high-level overview of how the integration with the vendor works

<aside> 👋 If you’re looking for general internal SparkPost guidance, please refer to SparkPost (SMTP/email delivery vendor) instead.

</aside>

Enabling managed SMTP for a Cloud instance

Generally, managed SMTP will be enabled by default.

To manually enable SMTP, enforce the smtp invariant with:

mi2 instance check -enforce smtp

Disabling managed SMTP for a Cloud instance

A customer should reach out to the account representative to have managed SMTP disabled.

Sourcegraph engineers can disable SMTP by setting the .spec.managedSMTP.disabled to true in the instance's config.yaml.

Vendor management

• Account
  • Okta and Entitle: Accounts are provisioned via Okta SSO using Entitle. Accounts should generally only be granted only Reporting access by default. Developer access accounts can be granted through Entitle for development purposes.