<a id="reference-integrations"></a>

# Integrations

<!-- Use the template below to add information about integrations supported by this charm. -->

## `postgresql`

*Interface*: `postgresql_client`
*Supported charms*: [`postgresql-k8s`](https://charmhub.io/postgresql-k8s),
[PostgreSQL](https://charmhub.io/postgresql)

Database integration is a required relation for the Mattermost charm to supply
structured data storage for Mattermost.

Database integrate command:

```default
juju integrate mattermost-k8s postgresql-k8s
```

## `s3`

*Interface*: `s3`
*Supported charms*: [`s3-integrator`](https://github.com/canonical/s3-integrator)

S3 integration allows Mattermost charm to store and retrieve files from an
S3-compatible storage service, instead of using the local `./data` folder.

Integrate command:

```default
juju integrate mattermost-k8s s3-integrator
```

## `smtp`

*Interface*: `smtp`
*Supported charms*: [`smtp-integrator`](https://charmhub.io/smtp-integrator)

SMTP integration enables Mattermost to send outgoing email notifications
(password resets, team invitations, and so on) through an external SMTP relay.

Integrate command:

```default
juju integrate mattermost-k8s smtp-integrator:smtp
```

## `oauth`

*Interface*: `oauth`
*Supported charms*: [`hydra-operator`](https://github.com/canonical/hydra-operator)

`oauth` integration allows the capability of authenticating users through `oauth`
Identity providers.

Integrate command:

```default
juju integrate mattermost-k8s hydra-operator:oauth
```
