---
title: Charmhub | Deploy Synapse using Charmhub - The Open Operator Collection
description: Deploy the latest version of Synapse as a Kubernetes Operator on any
  cloud.
url: https://charmhub.io/synapse/docs/how-to-configure-smtp
---

# Synapse

[Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

* [Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

Platform:

stable 426

```
juju deploy synapse
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

#### Relevant links

* [Homepage](https://github.com/canonical/synapse-operator)

---

#### Contacts

##### Maintainers

+ [Launchpad Team](https://launchpad.net/~canonical-is-devops)

* [Submit a bug](https://github.com/canonical/synapse-operator/issues)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

# How to integrate with SMTP for sending notifications

This document shows how to integrate Synapse with SMTP for sending
emails. Synapse should be deployed beforehand.

## [Deploy smtp-integrator charm](https://charmhub.io/synapse/docs/how-to-configure-smtp#p-30155-deploy-smtp-integrator-charm)

For Synapse to use SMTP, it uses the smtp-integrator charm. Replace the configuration options with your specific configuration.
Configuring SMTP without tls or starttls or without authentication is not supported.

```
juju deploy smtp-integrator --channel edge
juju config smtp-integrator host=<smtp host> port=<smtp port> user=<smtp auth user> password=<smtp auth password> auth_type=plain transport_security=tls
```

## [Configure email to use in `From`](https://charmhub.io/synapse/docs/how-to-configure-smtp#p-30155-configure-email-to-use-in-from)

Configure the “From” mail for Synapse with:

```
juju config synapse notif_from=<email to use in the "From" address>
```

## [Integrate with Synapse](https://charmhub.io/synapse/docs/how-to-configure-smtp#p-30155-integrate-with-synapse)

You can run it with the legacy integration `smtp-legacy` or with
the new integration using secrets `smtp`. A Juju version
with secrets is required for the `smtp` integration.

With the old integration without using secrets, run:

```
juju integrate smtp-integrator:smtp-legacy synapse:smtp
```

For the new integration with secrets, run:

```
juju integrate smtp-integrator:smtp synapse:smtp
```

---