ansol/matrix-docker-ansible-deploy
7
0
Fork 0
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy.git synced 2024-12-23 04:55:46 +00:00
Code Issues Projects Releases Wiki Activity
d997ac6e34
matrix-docker-ansible-deploy/README.md

204 lines
20 KiB
Markdown
Raw Normal View History

Add donation and support room badges
2020-12-01 13:24:07 +00:00
[![Support room on Matrix](https://img.shields.io/matrix/matrix-docker-ansible-deploy:devture.com.svg?label=%23matrix-docker-ansible-deploy%3Adevture.com&logo=matrix&style=for-the-badge&server_fqdn=matrix.devture.com)](https://matrix.to/#/#matrix-docker-ansible-deploy:devture.com) [![donate](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/s.pantaleev/donate)
Initial commit
2017-07-31 20:07:30 +00:00
# Matrix (An open network for secure, decentralized communication) server setup using Ansible and Docker
## Purpose
Make README more tidy
2021-01-24 08:04:30 +00:00
This [Ansible](https://www.ansible.com/) playbook is meant to help you run your own [Matrix](http://matrix.org/) homeserver, along with the [various services](#supported-services) related to that.
Initial commit
2017-07-31 20:07:30 +00:00
Replace <your-domain> with example.com Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
2024-10-17 13:19:28 +00:00
That is, it lets you join the Matrix network using your own `@<username>:example.com` identifier, all hosted on your own server (see [prerequisites](docs/prerequisites.md)).
Make README more tidy
2021-01-24 08:04:30 +00:00
We run all services in [Docker](https://www.docker.com/) containers (see [the container images we use](docs/container-images.md)), which lets us have a predictable and up-to-date setup, across multiple supported distros (see [prerequisites](docs/prerequisites.md)) and [architectures](docs/alternative-architectures.md) (x86/amd64 being recommended).
[Installation](docs/README.md) (upgrades) and some maintenance tasks are automated using [Ansible](https://www.ansible.com/) (see [our Ansible guide](docs/ansible.md)).
Bring back newlines
2021-05-17 13:10:54 +00:00
Update SaaS section in readme (#3455) * Update SaaS section in readme * Improve sentence wording * Improve sentence flow --------- Co-authored-by: Slavi Pantaleev <slavi@devture.com>
2024-07-30 13:02:48 +00:00
## Self-hosting or Managed / SaaS
Redo etke.cc section in the README
2023-02-26 13:54:30 +00:00
This Ansible playbook tries to make self-hosting and maintaining a Matrix server fairly easy. Still, running any service smoothly requires knowledge, time and effort.
Update SaaS section in readme (#3455) * Update SaaS section in readme * Improve sentence wording * Improve sentence flow --------- Co-authored-by: Slavi Pantaleev <slavi@devture.com>
2024-07-30 13:02:48 +00:00
If you like the [FOSS](https://en.wikipedia.org/wiki/Free_and_open-source_software) spirit of this Ansible playbook, but prefer to put the responsibility on someone else, you can also [get a managed Matrix server from etke.cc](https://etke.cc?utm_source=github&utm_medium=readme&utm_campaign=mdad) (both hosting and on-premises) - a service built on top of this Ansible playbook but with [additional components](https://etke.cc/help/extras/?utm_source=github&utm_medium=readme&utm_campaign=mdad) and [services](https://etke.cc/services/?utm_source=github&utm_medium=readme&utm_campaign=mdad) which all help you run a Matrix server with ease. Be advised that etke.cc operates on a subscription-based approach and there is no "just set up my server once and be done with it" option.
Redo etke.cc section in the README
2023-02-26 13:54:30 +00:00
Make README more tidy
2021-01-24 08:04:30 +00:00
## Supported services
Initial commit
2017-07-31 20:07:30 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
Using this playbook, you can get the following list of services configured on your server. Basically, this playbook aims to get you up-and-running with all the necessities around Matrix, without you having to do anything else.
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
**Note**: the list below is exhaustive. It includes optional or even some advanced components that you will most likely not need.
Sticking with the defaults (which install a subset of the above components) is the best choice, especially for a new installation.
You can always re-run the playbook later to add or remove components.
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
### Homeserver
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
The homeserver is the backbone of your matrix system. Choose one from the following list.
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| Name | Default? | Description | Documentation |
Announce Rageshake support
2023-02-25 12:04:20 +00:00
| ---- | -------- | ----------- | ------------- |
Replace (almost) all matrix-org/synapse references with element-hq/synapse Issues and Pull Requests were not migrated to the new organization/repository, so `matrix-org/synapse/pull` and `matrix-org/synapse/issues` references were kept as-is. `matrix-org/synapse-s3-storage-provider` references were also kept, as that module still continues living under the `matrix-org` organization. This patch mainly aims to change documentation-related things, not actual usage in full yet. For polish that, another more comprehensive patch is coming later.
2024-01-17 05:58:01 +00:00
| [Synapse](https://github.com/element-hq/synapse) | ✓ | Storing your data and managing your presence in the [Matrix](http://matrix.org/) network | [Link](docs/configuring-playbook-synapse.md) |
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| [Conduit](https://conduit.rs) | x | Storing your data and managing your presence in the [Matrix](http://matrix.org/) network. Conduit is a lightweight open-source server implementation of the Matrix Specification with a focus on easy setup and low system requirements | [Link](docs/configuring-playbook-conduit.md) |
added dendrite config doc link
2022-11-21 00:30:21 +00:00
| [Dendrite](https://github.com/matrix-org/dendrite) | x | Storing your data and managing your presence in the [Matrix](http://matrix.org/) network. Dendrite is a second-generation Matrix homeserver written in Go, an alternative to Synapse. | [Link](docs/configuring-playbook-dendrite.md) |
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
### Clients
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
Web clients for matrix that you can host on your own domains.
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| Name | Default? | Description | Documentation |
| ---- | -------- | ----------- | ------------- |
add SchildiChat client
2023-08-30 16:23:52 +00:00
| [Element](https://app.element.io/) | ✓ | Web UI, which is configured to connect to your own Synapse server by default | [Link](docs/configuring-playbook-client-element.md) |
refactor: update links to avoid future issue
2023-12-15 10:18:18 +00:00
| [Hydrogen](https://github.com/element-hq/hydrogen-web) | x | Lightweight matrix client with legacy and mobile browser support | [Link](docs/configuring-playbook-client-hydrogen.md) |
Add more descriptive description
2023-08-31 18:49:06 +00:00
| [Cinny](https://github.com/ajbura/cinny) | x | Simple, elegant and secure web client | [Link](docs/configuring-playbook-client-cinny.md) |
| [SchildiChat](https://schildi.chat/) | x | Based on Element, with a more traditional instant messaging experience | [Link](docs/configuring-playbook-client-schildichat.md) |
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
### Server Components
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
Services that run on the server to make the various parts of your installation work.
Add docs Unrelated to the original branch I added the matrix-registration bot as it was missing in the readme
2022-07-11 11:28:23 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| Name | Default? | Description | Documentation |
| ---- | -------- | ----------- | ------------- |
| [PostgreSQL](https://www.postgresql.org/)| ✓ | Database for Synapse. [Using an external PostgreSQL server](docs/configuring-playbook-external-postgres.md) is also possible. | [Link](docs/configuring-playbook-external-postgres.md) |
| [Coturn](https://github.com/coturn/coturn) | ✓ | STUN/TURN server for WebRTC audio/video calls | [Link](docs/configuring-playbook-turn.md) |
Switch default reverse-proxy to Traefik, force reverse-proxy choice on existing users
2023-02-26 14:14:05 +00:00
| [Traefik](https://doc.traefik.io/traefik/) | ✓ | Web server, listening on ports 80, 443 and 8448 - standing in front of all the other services. Using your own webserver [is possible](docs/configuring-playbook-own-webserver.md) | [Link](docs/configuring-playbook-traefik.md) |
| [Let's Encrypt](https://letsencrypt.org/) | ✓ | Free SSL certificate, which secures the connection to all components | [Link](docs/configuring-playbook-ssl-certificates.md) |
Fix Broken ma1sd Playbook Documentation Link Old link was pointing at `https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/master/configuring-playbook-ma1sd.md` which 404s New link at `https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/master/docs/configuring-playbook-ma1sd.md`
2022-12-09 14:15:43 +00:00
| [ma1sd](https://github.com/ma1uta/ma1sd) | x | Matrix Identity Server | [Link](docs/configuring-playbook-ma1sd.md)
Update README.md
2023-02-15 01:38:24 +00:00
| [Exim](https://www.exim.org/) | ✓ | Mail server, through which all Matrix services send outgoing email (can be configured to relay through another SMTP server) | [Link](docs/configuring-playbook-email.md) |
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| [Dimension](https://github.com/turt2live/matrix-dimension) | x | An open source integrations manager for matrix clients | [Link](docs/configuring-playbook-dimension.md) |
| [Sygnal](https://github.com/matrix-org/sygnal) | x | Push gateway | [Link](docs/configuring-playbook-sygnal.md) |
| [ntfy](https://ntfy.sh) | x | Push notifications server | [Link](docs/configuring-playbook-ntfy.md) |
Add docs Unrelated to the original branch I added the matrix-registration bot as it was missing in the readme
2022-07-11 11:28:23 +00:00
added honoroit
2022-01-06 18:30:10 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
### Authentication
update README
2022-08-22 17:29:48 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
Extend and modify how users are authenticated on your homeserver.
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| Name | Default? | Description | Documentation |
Announce Rageshake support
2023-02-25 12:04:20 +00:00
| ---- | -------- | ----------- | ------------- |
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| [matrix-synapse-rest-auth](https://github.com/ma1uta/matrix-synapse-rest-password-provider) (advanced) | x | REST authentication password provider module | [Link](docs/configuring-playbook-rest-auth.md) |
|[matrix-synapse-shared-secret-auth](https://github.com/devture/matrix-synapse-shared-secret-auth) (advanced) | x | Password provider module | [Link](docs/configuring-playbook-shared-secret-auth.md) |
Fix matrix-synapse-ldap3 docs link in README Fixes https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/2734
2023-06-11 18:28:22 +00:00
| [matrix-synapse-ldap3](https://github.com/matrix-org/matrix-synapse-ldap3) (advanced) | x | LDAP Auth password provider module | [Link](docs/configuring-playbook-ldap-auth.md) |
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| [matrix-ldap-registration-proxy](https://gitlab.com/activism.international/matrix_ldap_registration_proxy) (advanced) | x | A proxy that handles Matrix registration requests and forwards them to LDAP. | [Link](docs/configuring-playbook-matrix-ldap-registration-proxy.md) |
| [matrix-registration](https://github.com/ZerataX/matrix-registration) | x | A simple python application to have a token based matrix registration | [Link](docs/configuring-playbook-matrix-registration.md) |
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
### File Storage
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
Use alternative file storage to the default `media_store` folder.
Bring back newlines
2021-05-17 13:10:54 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| Name | Default? | Description | Documentation |
| ---- | -------- | ----------- | ------------- |
| [Goofys](https://github.com/kahing/goofys) | x | [Amazon S3](https://aws.amazon.com/s3/) (or other S3-compatible object store) storage for Synapse's content repository (`media_store`) files | [Link](docs/configuring-playbook-s3-goofys.md) |
| [synapse-s3-storage-provider](https://github.com/matrix-org/synapse-s3-storage-provider) | x | [Amazon S3](https://aws.amazon.com/s3/) (or other S3-compatible object store) storage for Synapse's content repository (`media_store`) files | [Link](docs/configuring-playbook-s3.md) |
fix link to configuring-playbook-matrix-media-repo.md
2023-09-23 09:18:53 +00:00
| [matrix-media-repo](https://github.com/turt2live/matrix-media-repo) | x | matrix-media-repo is a highly customizable multi-domain media repository for Matrix. Intended for medium to large deployments, this media repo de-duplicates media while being fully compliant with the specification. | [Link](docs/configuring-playbook-matrix-media-repo.md) |
Add Sygnal support Fixes https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/683
2021-03-20 11:31:34 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
### Bridges
matrix-ntfy: list in playbook's README.md
2022-07-05 20:00:55 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
Bridges can be used to connect your matrix installation with third-party communication networks.
Add docs
2021-05-21 09:43:04 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| Name | Default? | Description | Documentation |
| ---- | -------- | ----------- | ------------- |
Improve bridge descriptions
2023-08-31 18:59:38 +00:00
| [mautrix-discord](https://github.com/mautrix/discord) | x | Bridge to [Discord](https://discord.com/) | [Link](docs/configuring-playbook-bridge-mautrix-discord.md) |
| [mautrix-slack](https://github.com/mautrix/slack) | x | Bridge to [Slack](https://slack.com/) | [Link](docs/configuring-playbook-bridge-mautrix-slack.md) |
| [mautrix-telegram](https://github.com/mautrix/telegram) | x | Bridge to [Telegram](https://telegram.org/) | [Link](docs/configuring-playbook-bridge-mautrix-telegram.md) |
| [mautrix-gmessages](https://github.com/mautrix/gmessages) | x | Bridge to [Google Messages](https://messages.google.com/) | [Link](docs/configuring-playbook-bridge-mautrix-gmessages.md) |
| [mautrix-whatsapp](https://github.com/mautrix/whatsapp) | x | Bridge to [WhatsApp](https://www.whatsapp.com/) | [Link](docs/configuring-playbook-bridge-mautrix-whatsapp.md) |
| [mautrix-facebook](https://github.com/mautrix/facebook) | x | Bridge to [Facebook](https://facebook.com/) | [Link](docs/configuring-playbook-bridge-mautrix-facebook.md) |
| [mautrix-twitter](https://github.com/mautrix/twitter) | x | Bridge to [Twitter](https://twitter.com/) | [Link](docs/configuring-playbook-bridge-mautrix-twitter.md) |
| [mautrix-hangouts](https://github.com/mautrix/hangouts) | x | Bridge to [Google Hangouts](https://en.wikipedia.org/wiki/Google_Hangouts) | [Link](docs/configuring-playbook-bridge-mautrix-hangouts.md) |
| [mautrix-googlechat](https://github.com/mautrix/googlechat) | x | Bridge to [Google Chat](https://en.wikipedia.org/wiki/Google_Chat) | [Link](docs/configuring-playbook-bridge-mautrix-googlechat.md) |
| [mautrix-instagram](https://github.com/mautrix/instagram) | x | Bridge to [Instagram](https://instagram.com/) | [Link](docs/configuring-playbook-bridge-mautrix-instagram.md) |
| [mautrix-signal](https://github.com/mautrix/signal) | x | Bridge to [Signal](https://www.signal.org/) | [Link](docs/configuring-playbook-bridge-mautrix-signal.md) |
| [beeper-linkedin](https://github.com/beeper/linkedin) | x | Bridge to [LinkedIn](https://www.linkedin.com/) | [Link](docs/configuring-playbook-bridge-beeper-linkedin.md) |
| [matrix-appservice-irc](https://github.com/matrix-org/matrix-appservice-irc) | x | Bridge to [IRC](https://wikipedia.org/wiki/Internet_Relay_Chat) | [Link](docs/configuring-playbook-bridge-appservice-irc.md) |
| [matrix-appservice-discord](https://github.com/Half-Shot/matrix-appservice-discord) | x | Bridge to [Discord](https://discordapp.com/) | [Link](docs/configuring-playbook-bridge-appservice-discord.md) |
| [matrix-appservice-slack](https://github.com/matrix-org/matrix-appservice-slack) | x | Bridge to [Slack](https://slack.com/) | [Link](docs/configuring-playbook-bridge-appservice-slack.md) |
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| [matrix-appservice-webhooks](https://github.com/turt2live/matrix-appservice-webhooks) | x | Bridge for slack compatible webhooks ([ConcourseCI](https://concourse-ci.org/), [Slack](https://slack.com/) etc. pp.) | [Link](docs/configuring-playbook-bridge-appservice-webhooks.md) |
Improve bridge descriptions
2023-08-31 18:59:38 +00:00
| [matrix-hookshot](https://github.com/Half-Shot/matrix-hookshot) | x | Bridge for generic webhooks and multiple project management services, such as GitHub, GitLab, Figma, and Jira in particular | [Link](docs/configuring-playbook-bridge-hookshot.md) |
| [matrix-sms-bridge](https://github.com/benkuly/matrix-sms-bridge) | x | Bridge to SMS | [Link](docs/configuring-playbook-bridge-matrix-bridge-sms.md) |
| [Heisenbridge](https://github.com/hifi/heisenbridge) | x | Bouncer-style bridge to [IRC](https://wikipedia.org/wiki/Internet_Relay_Chat) | [Link](docs/configuring-playbook-bridge-heisenbridge.md) |
| [go-skype-bridge](https://github.com/kelaresg/go-skype-bridge) | x | Bridge to [Skype](https://www.skype.com) | [Link](docs/configuring-playbook-bridge-go-skype-bridge.md) |
| [mx-puppet-slack](https://hub.docker.com/r/sorunome/mx-puppet-slack) | x | Bridge to [Slack](https://slack.com) | [Link](docs/configuring-playbook-bridge-mx-puppet-slack.md) |
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| [mx-puppet-instagram](https://github.com/Sorunome/mx-puppet-instagram) | x | Bridge for Instagram-DMs ([Instagram](https://www.instagram.com/)) | [Link](docs/configuring-playbook-bridge-mx-puppet-instagram.md) |
| [mx-puppet-twitter](https://github.com/Sorunome/mx-puppet-twitter) | x | Bridge for Twitter-DMs ([Twitter](https://twitter.com/)) | [Link](docs/configuring-playbook-bridge-mx-puppet-twitter.md) |
Improve bridge descriptions
2023-08-31 18:59:38 +00:00
| [mx-puppet-discord](https://github.com/matrix-discord/mx-puppet-discord) | x | Bridge to [Discord](https://discordapp.com/) | [Link](docs/configuring-playbook-bridge-mx-puppet-discord.md) |
| [mx-puppet-groupme](https://gitlab.com/xangelix-pub/matrix/mx-puppet-groupme) | x | Bridge to [GroupMe](https://groupme.com/) | [Link](docs/configuring-playbook-bridge-mx-puppet-groupme.md) |
| [mx-puppet-steam](https://github.com/icewind1991/mx-puppet-steam) | x | Bridge to [Steam](https://steamapp.com/) | [Link](docs/configuring-playbook-bridge-mx-puppet-steam.md) |
| [Email2Matrix](https://github.com/devture/email2matrix) | x | Bridge for relaying emails to Matrix rooms | [Link](docs/configuring-playbook-email2matrix.md) |
added matrix-client-cinny
2022-01-05 16:33:21 +00:00
add borg backup (#1727) * add borg backup * lint fix * add exlclude patterns * missed in the #1726 fix for honoroit * feedback * Fix indentation * feedback * feedback * feedback Co-authored-by: Slavi Pantaleev <slavi@devture.com>
2022-04-05 11:37:27 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
### Bots
add buscarron to the readme
2022-04-23 14:11:24 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
Bots provide various additional functionality to your installation.
Cactus comments (#2089) * Add construct for cactus comments role * Adjust config files * Add docker self build to defaults * Adjust tasks * Fix smaller syntax errors * Fix env argument * Add tmp path to allow container writing there Background why I did this: https://docs.gunicorn.org/en/stable/settings.html#worker-tmp-dir * Change port back to 5000 as not configurable in container * Try to add appservice config file for synapse to use * Inject appservice file * Correct copied variable name * Comment out unused app service file injection would need mounting the appservice file to the synapse container i guess * Move role before synapse to be able to inject during runtime * Remove unused parts * Change default user id to mirror official docs * Add docs * Update roles/matrix-cactus-comments/tasks/setup_install.yml Co-authored-by: Slavi Pantaleev <slavi@devture.com> * Update roles/matrix-cactus-comments/templates/cactus_appservice.yaml.j2 Co-authored-by: Slavi Pantaleev <slavi@devture.com> * Generate secrets if necessary, adjust docs * Rename cactusbot userid * Shorten salt strings Co-authored-by: Slavi Pantaleev <slavi@devture.com> * Use tmpfs instead of persistent mount * Remove proxy option as it is nonsense * Add download and serving of cc-client files * Add documentation on client * Clarify docs a bit * Add nginx proxy to required services Signed-off-by: Julian-Samuel Gebühr <julian-samuel@gebuehr.net> * Use container address Signed-off-by: Julian-Samuel Gebühr <julian-samuel@gebuehr.net> * Correct comment of user id Signed-off-by: Julian-Samuel Gebühr <julian-samuel@gebuehr.net> * Use releases or local distributed client Signed-off-by: Julian-Samuel Gebühr <julian-samuel@gebuehr.net> * Move homeserver url to defaults Signed-off-by: Julian-Samuel Gebühr <julian-samuel@gebuehr.net> * Correct truth value Signed-off-by: Julian-Samuel Gebühr <julian-samuel@gebuehr.net> * Add documentation of variables Co-authored-by: Slavi Pantaleev <slavi@devture.com> * Tabs vs. spaces Co-authored-by: Slavi Pantaleev <slavi@devture.com> * Make nginx root configurable Signed-off-by: Julian-Samuel Gebühr <julian-samuel@gebuehr.net> * Complete ake nginx root configurable Signed-off-by: Julian-Samuel Gebühr <julian-samuel@gebuehr.net> * Fix file permission Signed-off-by: Julian-Samuel Gebühr <julian-samuel@gebuehr.net> * Fix lint errors Signed-off-by: Julian-Samuel Gebühr <julian-samuel@gebuehr.net> Signed-off-by: Julian-Samuel Gebühr <julian-samuel@gebuehr.net> Co-authored-by: Slavi Pantaleev <slavi@devture.com>
2022-09-09 11:37:52 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| Name | Default? | Description | Documentation |
| ---- | -------- | ----------- | ------------- |
Add support for baibot Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3369
2024-09-12 12:19:40 +00:00
| [baibot](https://github.com/etkecc/baibot) | x | A bot that exposes the power of [AI](https://en.wikipedia.org/wiki/Artificial_intelligence) / [Large Language Models](https://en.wikipedia.org/wiki/Large_language_model) to you | [Link](docs/configuring-playbook-bot-baibot.md) |
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| [matrix-reminder-bot](https://github.com/anoadragon453/matrix-reminder-bot) | x | Bot for scheduling one-off & recurring reminders and alarms | [Link](docs/configuring-playbook-bot-matrix-reminder-bot.md) |
| [matrix-registration-bot](https://github.com/moan0s/matrix-registration-bot) | x | Bot for invitations by creating and managing registration tokens | [Link](docs/configuring-playbook-bot-matrix-registration-bot.md) |
| [maubot](https://github.com/maubot/maubot) | x | A plugin-based Matrix bot system | [Link](docs/configuring-playbook-bot-maubot.md) |
Switch all etke.cc links (from Gitlab to Github) Related to https://etke.cc/news/d3uw4utq4t3_rpxicrrfqqou_ynmptqjgk95pt-3n2s/
2024-09-06 23:43:00 +00:00
| [honoroit](https://github.com/etkecc/honoroit) | x | A helpdesk bot | [Link](docs/configuring-playbook-bot-honoroit.md) |
| [Postmoogle](https://github.com/etkecc/postmoogle) | x | Email to matrix bot | [Link](docs/configuring-playbook-bot-postmoogle.md) |
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| [Go-NEB](https://github.com/matrix-org/go-neb) | x | A multi functional bot written in Go | [Link](docs/configuring-playbook-bot-go-neb.md) |
| [Mjolnir](https://github.com/matrix-org/mjolnir) | x | A moderation tool for Matrix | [Link](docs/configuring-playbook-bot-mjolnir.md) |
Replace links to Gnuxie/Draupnir with the-draupnir-project/Draupnir Draupnir moved its repo on github from the namespace of its maintainer Gnuxie to a newly created Github Organisation the-draupnir-project and this commit reflects this.
2023-09-07 17:33:25 +00:00
| [Draupnir](https://github.com/the-draupnir-project/Draupnir) | x | A moderation tool for Matrix (Fork of Mjolnir) | [Link](docs/configuring-playbook-bot-draupnir.md) |
Switch all etke.cc links (from Gitlab to Github) Related to https://etke.cc/news/d3uw4utq4t3_rpxicrrfqqou_ynmptqjgk95pt-3n2s/
2024-09-06 23:43:00 +00:00
| [Buscarron](https://github.com/etkecc/buscarron) | x | Web forms (HTTP POST) to matrix | [Link](docs/configuring-playbook-bot-buscarron.md) |
Add matrix-bot-chatgpt. Co-Authored-By: Slavi Pantaleev <slavi@devture.com>
2023-01-02 18:16:38 +00:00
| [matrix-chatgpt-bot](https://github.com/matrixgpt/matrix-chatgpt-bot) | x | ChatGPT from matrix | [Link](docs/configuring-playbook-bot-chatgpt.md) |
Initial commit
2017-07-31 20:07:30 +00:00
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
### Administration
Services that help you in administrating and monitoring your matrix installation.
| Name | Default? | Description | Documentation |
| ---- | -------- | ----------- | ------------- |
| [synapse-admin](https://github.com/Awesome-Technologies/synapse-admin) | x | A web UI tool for administrating users and rooms on your Matrix server | [Link](docs/configuring-playbook-synapse-admin.md) |
| Metrics and Graphs | x | Consists of the [Prometheus](https://prometheus.io) time-series database server, the Prometheus [node-exporter](https://prometheus.io/docs/guides/node-exporter/) host metrics exporter, and the [Grafana](https://grafana.com/) web UI | [Link](docs/configuring-playbook-prometheus-grafana.md) |
| [Borg](https://borgbackup.org) | x | Backups | [Link](docs/configuring-playbook-backup-borg.md) |
Announce Rageshake support
2023-02-25 12:04:20 +00:00
| [Rageshake](https://github.com/matrix-org/rageshake) | x | Bug report server | [Link](docs/configuring-playbook-rageshake.md) |
Created role for synapse-usage-exporter (#3442) * Created role for synapse-usage-exporter * Apply suggestions from code review Co-authored-by: Slavi Pantaleev <slavi@devture.com> * Renaming docker variables and moving synapse stats config location * Respect devture_systemd_docker_base_docker_service_name --------- Co-authored-by: Slavi Pantaleev <slavi@devture.com>
2024-07-25 17:19:08 +00:00
| [synapse-usage-exporter](https://github.com/loelkes/synapse-usage-exporter) | x | Export the usage statistics of a Synapse homeserver to be scraped by Prometheus. | [Link](docs/configuring-playbook-synapse-usage-exporter.md) |
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
### Misc
Various services that don't fit any other category.
| Name | Default? | Description | Documentation |
| ---- | -------- | ----------- | ------------- |
Announce sliding-sync support Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/pull/2515
2023-03-07 10:22:04 +00:00
| [sliding-sync](https://github.com/matrix-org/sliding-sync)| x | Sliding Sync support for clients which require it (e.g. Element X) | [Link](docs/configuring-playbook-sliding-sync-proxy.md) |
Add Synapse module auto accept invite to rooms and direct messages (#3195) * feat: auto-accept-invite module and docs * fix: name typos and some forgot to adjust variables * fix: accept only direct messages should work now and better wording * changed: only_direct_messages variable naming * feat: add logger, add synapse workers config * Fix typo and add details about synapse-auto-acccept-invite * Add newline at end of file * Fix alignment * Fix logger name for synapse_auto_accept_invite The name of the logger needs to match the name of the Python module. Ref: https://github.com/matrix-org/synapse-auto-accept-invite/blob/d673c6767862e0340e58f6e9947c7d90ec190201/synapse_auto_accept_invite/__init__.py#L20 * Add missing document start YAML annotation * Remove trailing spaces --------- Co-authored-by: Slavi Pantaleev <slavi@devture.com>
2024-02-21 16:04:14 +00:00
| [synapse_auto_accept_invite](https://github.com/matrix-org/synapse-auto-accept-invite) | x | A Synapse module to automatically accept invites. | [Link](docs/configuring-playbook-synapse-auto-accept-invite.md) |
add synapse_auto_compressor
2023-03-10 21:48:43 +00:00
| [synapse_auto_compressor](https://github.com/matrix-org/rust-synapse-compress-state/#automated-tool-synapse_auto_compressor) | x | A cli tool that automatically compresses `state_groups` database table in background. | [Link](docs/configuring-playbook-synapse-auto-compressor.md) |
Restructure the list of services in the README.md - Tried to split the list of services into distinct categories - Use tables instead of a list - Dropped "optional" flag, as every service is now optional anyways - Added links to the documentation where docs exist and were missing before - Split "Amazon S3" entry into two entries (Goofys and synapse-s3-storage-provider) - Moved note about not needing all services to the top of the section
2022-11-19 15:18:32 +00:00
| [synapse-simple-antispam](https://github.com/t2bot/synapse-simple-antispam) (advanced) | x | A spam checker module | [Link](docs/configuring-playbook-synapse-simple-antispam.md) |
| [Matrix Corporal](https://github.com/devture/matrix-corporal) (advanced) | x | Reconciliator and gateway for a managed Matrix server | [Link](docs/configuring-playbook-matrix-corporal.md) |
| [Etherpad](https://etherpad.org) | x | An open source collaborative text editor | [Link](docs/configuring-playbook-etherpad.md) |
| [Jitsi](https://jitsi.org/) | x | An open source video-conferencing platform | [Link](docs/configuring-playbook-jitsi.md) |
| [Cactus Comments](https://cactus.chat) | x | A federated comment system built on matrix | [Link](docs/configuring-playbook-cactus-comments.md) |
Add Pantalaimon support This is actually authored by Julian Foad here (https://lab.trax.im/matrix/matrix-docker-ansible-deploy), but was in need of a rebase and various adjustments caused by huge playbook refactoring that landed in the past months. This rework is completely untested. Fixes https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/266
2024-03-24 16:25:19 +00:00
| [Pantalaimon](https://github.com/matrix-org/pantalaimon) | x | An E2EE aware proxy daemon | [Link](docs/configuring-playbook-pantalaimon.md) |
Make it clearer that not all components are necessary
2018-11-26 08:35:08 +00:00
Bring back newlines
2021-05-17 13:10:54 +00:00
Split README into a bunch of files in docs/
2018-08-08 07:07:02 +00:00
## Installation
Initial commit
2017-07-31 20:07:30 +00:00
Split README into a bunch of files in docs/
2018-08-08 07:07:02 +00:00
To configure and install Matrix on your own server, follow the [README in the docs/ directory](docs/README.md).
Initial commit
2017-07-31 20:07:30 +00:00
Bring back newlines
2021-05-17 13:10:54 +00:00
Split README into a bunch of files in docs/
2018-08-08 07:07:02 +00:00
## Changes
Initial commit
2017-07-31 20:07:30 +00:00
Split README into a bunch of files in docs/
2018-08-08 07:07:02 +00:00
This playbook evolves over time, sometimes with backward-incompatible changes.
Bring back newlines
2021-05-17 13:10:54 +00:00
Split README into a bunch of files in docs/
2018-08-08 07:07:02 +00:00
When updating the playbook, refer to [the changelog](CHANGELOG.md) to catch up with what's new.
Add support for not taking over a server (no matrix-nginx-proxy) and disabling Riot
2017-09-12 09:41:44 +00:00
Bring back newlines
2021-05-17 13:10:54 +00:00
Add support information
2018-05-29 06:58:36 +00:00
## Support
Add information about the IRC support channel
2018-11-23 11:23:01 +00:00
- Matrix room: [#matrix-docker-ansible-deploy:devture.com](https://matrix.to/#/#matrix-docker-ansible-deploy:devture.com)
Bring back newlines
2021-05-17 13:10:54 +00:00
Update IRC channel
2021-05-27 20:21:47 +00:00
- IRC channel: `#matrix-docker-ansible-deploy` on the [Libera Chat](https://libera.chat/) IRC network (irc.libera.chat:6697)
Bring back newlines
2021-05-17 13:10:54 +00:00
Fixed typos in README Hi, I used [LanguageTool](https://languagetool.org) to fix typos in README
2021-05-12 19:52:23 +00:00
- GitHub issues: [spantaleev/matrix-docker-ansible-deploy/issues](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues)
Add Related plabooks
2023-02-26 14:21:50 +00:00
## Related
Reword the Related secton of the README
2023-12-14 09:35:01 +00:00
You may also be interested in [mash-playbook](https://github.com/mother-of-all-self-hosting/mash-playbook) - another Ansible playbook for self-hosting non-Matrix services (see its [List of supported services](https://github.com/mother-of-all-self-hosting/mash-playbook/blob/main/docs/supported-services.md)).
Add Related plabooks
2023-02-26 14:21:50 +00:00
Reword the Related secton of the README
2023-12-14 09:35:01 +00:00
mash-playbook also makes use of [Traefik](./docs/configuring-playbook-traefik.md) as its reverse-proxy, so with minor [interoperability adjustments](https://github.com/mother-of-all-self-hosting/mash-playbook/blob/main/docs/interoperability.md), you can make matrix-docker-ansible-deploy and mash-playbook co-exist and host Matrix and non-Matrix services on the same server.
Reference in New Issue Copy Permalink