# `finallycoffee.matrix.synapse` ansible role

## Configuration

### Required

The following variables need to be populated:

- `synapse_domain` - the domain this homeserver should be authoritative for.
- `synapse_signing_key` - the signing key synapse should use.
  Set either this or `synapse_role_generate_signing_key: true`.

## Other

- [Configure your database](docs/database.md)
- [Configure your listeners](docs/listeners.md)
- [Configure logging](docs/logging.md)

## Deployment methods

- `docker`
- `podman`
- `venv` - Python virtual env supervised with `systemd`

Set `synapse_deployment_method` to one of the supported deployment methods.
The current default is `docker`.