mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2025-04-25 17:51:52 +00:00

This is an initial implementaton that's hasn't been battle-tested much. Our LiveKit Server setup by default doesn't enable TURN, so connectivity for NAT-ed clients may be subpar. Squashed commit of the following: commitd5c24fcafe
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Mar 15 08:31:48 2025 +0200 Upgrade LiveKit Server (v1.8.4-1 -> v1.8.4-2) commit4d61cc571b
Merge:9c24064fb
9a231a815
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Mar 15 08:19:05 2025 +0200 Merge branch 'master' into element-call-integration commit9c24064fb6
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Mar 15 08:14:49 2025 +0200 Make Element Call fail during validation if on an unsupported architecture (like arm32) commita757b515fb
Merge:ba9cedbed
2a6b746ac
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Mar 15 08:11:16 2025 +0200 Merge branch 'master' into element-call-integration commitba9cedbeda
Merge:4a638c2df
f8f7ffc7d
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Mar 15 08:03:03 2025 +0200 Merge branch 'master' into element-call-integration commit4a638c2df3
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Mar 15 07:52:04 2025 +0200 Prepare Element Call announcement text on the changelog commit155d5dad38
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Mar 15 07:49:49 2025 +0200 Mention the compatible clients on Element Call docs, more cross-linking & consistency fixes commit6b8a3fc891
Merge:3ea1ea2f3
95dcaf6e2
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Mar 15 07:38:02 2025 +0200 Merge branch 'master' into element-call-integration commit3ea1ea2f34
Merge:d3913a015
60e2e035a
Author: Slavi Pantaleev <slavi@devture.com> Date: Fri Mar 14 22:29:14 2025 +0200 Merge branch 'master' into element-call-integration commitd3913a015e
Author: Slavi Pantaleev <slavi@devture.com> Date: Fri Mar 14 20:04:18 2025 +0200 Upgrade LiveKit Server (v1.8.4-0 -> v1.8.4-1) commitac7f96806d
Author: Slavi Pantaleev <slavi@devture.com> Date: Fri Mar 14 19:58:09 2025 +0200 Relocate the livekit-server Ansible role to its own repository in the MASH organization commitb8d800f6ef
Author: Slavi Pantaleev <slavi@devture.com> Date: Fri Mar 14 19:37:29 2025 +0200 Add "Federation" as a prerequisite for Element Call (indirect, via LiveKit JWT Service) Ref: - https://github.com/spantaleev/matrix-docker-ansible-deploy/pull/3562#issuecomment-2725250554 -f5f5374c4b/main.go (L135-L146)
commit2c1c49444a
Merge:6bc0185d5
8e883a555
Author: Slavi Pantaleev <slavi@devture.com> Date: Fri Mar 14 19:32:48 2025 +0200 Merge branch 'master' into element-call-integration commit6bc0185d50
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Mar 13 09:43:22 2025 +0200 Add Element Call, LiveKit Server and LiveKit JWT Service to `README.md` Ref: https://github.com/spantaleev/matrix-docker-ansible-deploy/pull/3562#issuecomment-2720039742 commita0470fe248
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 19:12:30 2025 +0200 Minor rewording in LiveKit Server docs commitd4ceebc6a9
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 19:12:22 2025 +0200 Add Element Call, LiveKit Server and LiveKit JWT Service to `docs/container-images.md` commit6a86de958f
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 19:05:51 2025 +0200 Apply suggestions from code review Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commitd9df022d55
Merge:676f9dd9a
2f30886b1
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 18:40:31 2025 +0200 Merge branch 'master' into element-call-integration commit676f9dd9ad
Merge:251561ff8
2be709e2c
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 18:00:45 2025 +0200 Merge branch 'master' into element-call-integration commit251561ff81
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 17:47:01 2025 +0200 Simplify LiveKit Server role by removing unused/untested HTTP middleware variables commit1e60f41a59
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 17:44:00 2025 +0200 Restore Element Call HTTP headers to more secure/privacy-respecting values commitf8e84c4b2f
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 17:43:34 2025 +0200 Remove useless `matrix_element_call_port` variable commit3f5e8f656b
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 17:35:30 2025 +0200 Switch default LiveKit server endpoint to one under the `matrix.` domain and polish-up docs commit72118f2f03
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 16:56:06 2025 +0200 Fix LiveKitServer middlware name (`matrix-livekit-server-server-slashless-redirect` -> `matrix-livekit-server-slashless-redirect`) commit585377975b
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 16:51:10 2025 +0200 Adjust LiveKit Server ports and exposure commit22ef579444
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 15:44:31 2025 +0200 Make livekit-jwt-service communicate with livekit-server via public URLs Communicating via container URLs works, but the URL provided to livekit-jwt-service as `LIVEKIT_URL` is also passed to the user later and it must be a public one at that point. It'd be great if livekit-jwt-service can be given 2 different URLs (e.g. `LIVEKIT_URL` and `LIVEKIT_URL_PUBLIC`) and only announce the public one to the user, but there's no support for this yet. commit32f8c6de6e
Merge:370feb740
79cc333be
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 15:27:42 2025 +0200 Merge branch 'master' into element-call-integration commit370feb740f
Merge:9a11e5e1f
a9ee537f8
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 10:04:19 2025 +0200 Merge branch 'master' into element-call-integration commit9a11e5e1fe
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 09:19:03 2025 +0200 Auto-enable experimental Synapse features required by Element Call when Element Call is enabled commit8291b2f99d
Merge:890f10f76
c5a03efdf
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 09:14:50 2025 +0200 Merge branch 'master' into element-call-integration commit890f10f765
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 09:01:35 2025 +0200 Make `matrix_livekit_jwt_service_public_url` respect `matrix_livekit_jwt_service_path_prefix` commit031cf68cbb
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 08:59:50 2025 +0200 Remove unused `matrix_element_call_metrics_*` variables commit5961841e52
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 08:59:05 2025 +0200 Make matrix-livekit-jwt-service role not reference foreign variables (except the matrix-base ones) commit2be4923aef
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 08:56:15 2025 +0200 Make Element Call role not reference foreign variables (except the matrix-base ones) commit23efad9cb7
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 08:51:52 2025 +0200 Rework Element Call config.json templating commit6b55ba29ab
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 08:46:11 2025 +0200 Make Element Call refuse a path prefix other than `/` commit0d1112638d
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 08:05:42 2025 +0200 Update LiveKit JWT service path prefix (`/lk-jwt-service` -> `/livekit-jwt-service`) commitc3c2ba34b4
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 08:02:29 2025 +0200 Split `matrix_element_call_systemd_required_services_list` into `_default`, `_auto` and `_custom` commit0215708f79
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 08:00:28 2025 +0200 Remove some useless variables and rework environment variables variable for livekit-jwt-service commite1b57f3d45
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 07:56:47 2025 +0200 Pin livekit-jwt-service to released (v0.2.0) and adapt configuration commitde2a8f11d2
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 07:46:51 2025 +0200 `_name_prefix` -> `_registry_prefix` changes for LiveKit roles commit2a69ca35be
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 07:42:40 2025 +0200 Clean up Element Call group vars vs defaults/main.yml mixup and make some minor LiveKit updates commit72d64cfa6b
Merge:f161c7c58
5dfbefd64
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 07:03:53 2025 +0200 Merge branch 'master' into element-call-integration commitf161c7c58f
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 07:03:00 2025 +0200 Add newlines at end of files commit6c6b44dc25
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 06:58:00 2025 +0200 Add license information to Element Call and LiveKit roles commit8eb1c57e2b
Merge:61069d631
aa36acdef
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 06:36:48 2025 +0200 Merge branch 'master' into element-call-integration commit61069d6313
Merge:74d6a99b1
0b9389fd6
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 06:34:00 2025 +0200 Merge branch 'element-call-integration' of github.com:wjbeckett/matrix-docker-ansible-deploy into element-call-integration commit74d6a99b1e
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 06:32:22 2025 +0200 Adjust names for Element Call tasks and make uninstallation more consistent with other roles commit81a30f17ac
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 06:29:39 2025 +0200 Remove some superficial comments commit413d591562
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 06:27:11 2025 +0200 Bring container-network-creation tasks up-to-date for Element Call and LiveKit-related services commit7572522820
Merge:564275527
5ece1fea5
Author: Slavi Pantaleev <slavi@devture.com> Date: Wed Mar 12 06:24:34 2025 +0200 Merge branch 'master' into element-call-integration commit0b9389fd64
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Nov 23 17:43:52 2024 +0200 Update docs/configuring-playbook-livekit-server.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit9a8a569431
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Nov 23 17:43:29 2024 +0200 Update docs/configuring-playbook-element-call.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commitbb403e1aee
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Nov 23 17:43:15 2024 +0200 Update docs/configuring-playbook-jwt-service.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit74fbacbd9f
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Nov 23 17:42:54 2024 +0200 Update docs/configuring-playbook-element-call.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit5642755273
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Nov 23 16:40:50 2024 +0200 Rework LiveKit JWT Service role commitbb925f4782
Merge:c57d0d192
ca8c1cf2b
Author: Slavi Pantaleev <slavi@devture.com> Date: Sat Nov 23 14:45:20 2024 +0200 Merge branch 'master' into element-call-integration commitc57d0d192d
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 19:45:07 2024 +0200 Eliminate remaining matrix references from LiveKit Server role commit006920882c
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 19:38:23 2024 +0200 Rename file (element-call-labels -> labels) commit69d702643f
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 19:36:55 2024 +0200 Remove homeserver.yaml patching from Element Call role commit252ca52f60
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 19:32:15 2024 +0200 Relocate /.well-known/element/element.json setup to matrix-static-files, instead of ugly patching from the Element Call role commit3f52cec25c
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 19:17:30 2024 +0200 Relocate Element Web features & element_call configuration to Element role, instead of ugly patching from the Element Call role commit7a6fcaa402
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 18:59:11 2024 +0200 Fix typo commit394fdca066
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 18:54:29 2024 +0200 Relocate org.matrix.msc4143.rtc_foci setup to /.well-known/matrix/client to matrix-static-files instead of ugly patching commitf0466d5a99
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 18:19:36 2024 +0200 Make LiveKit Server configuration extensible commitbe7271760e
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 18:13:07 2024 +0200 Make LiveKit Server logging config configurable commit8b84eb6390
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 18:04:53 2024 +0200 Default LiveKit Server to a smaller RTC range for faster startup on non-host networks commit3e86adac0d
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 18:00:43 2024 +0200 Fix port exposure for LiveKit Server commit721fb39aa2
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 17:28:06 2024 +0200 More progress on the LiveKit role commit783d4a23f8
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:54:45 2024 +0200 Add livekit_server_identifier commitfa4ebd2a64
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:37:01 2024 +0200 Cleanups commit79ae704a24
Merge:88d466845
c07b09390
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:31:50 2024 +0200 Merge branch 'element-call-integration' of github.com:wjbeckett/matrix-docker-ansible-deploy into element-call-integration commitc07b093902
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:24:34 2024 +0200 Update docs/configuring-playbook-livekit-server.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commitc321ca160e
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:24:26 2024 +0200 Update docs/configuring-playbook-livekit-server.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit164be875b0
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:24:15 2024 +0200 Update docs/configuring-playbook-livekit-server.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit0f23e36e12
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:24:05 2024 +0200 Update docs/configuring-playbook-livekit-server.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit83bb546c64
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:23:55 2024 +0200 Update docs/configuring-playbook-livekit-server.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit3783922275
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:23:47 2024 +0200 Update docs/configuring-playbook-livekit-server.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit66cc36466c
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:23:36 2024 +0200 Update docs/configuring-playbook-livekit-server.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commitec41c1aba5
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:23:28 2024 +0200 Update docs/configuring-playbook-jwt-service.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commitdf6ef106d1
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:23:18 2024 +0200 Update docs/configuring-playbook-jwt-service.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commiteb048da8a1
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:23:06 2024 +0200 Update docs/configuring-playbook-jwt-service.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commitccb29beb30
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:22:56 2024 +0200 Update docs/configuring-playbook-jwt-service.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit32ea60fdc5
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:22:44 2024 +0200 Update docs/configuring-playbook-element-call.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit25a8cb3b4a
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:22:17 2024 +0200 Update docs/configuring-playbook-element-call.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit55da5c3213
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:21:55 2024 +0200 Update docs/configuring-playbook-element-call.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit925ebfbd4b
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:21:42 2024 +0200 Update docs/configuring-playbook-element-call.md Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit88d4668450
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:16:43 2024 +0200 Variable rename (livekit_server_image -> livekit_server_container_image) for consistency with other roles commit1838a541ae
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 16:15:54 2024 +0200 Variables rename (matrix_livekit_server_ -> livekit_server_) to prepare for role extraction commit1e82530080
Merge:82127830b
0c9fc4358
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 15:59:56 2024 +0200 Merge branch 'master' into element-call-integration commit82127830b3
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 15:58:01 2024 +0200 Update roles/custom/matrix-livekit-server/tasks/uninstall.yml Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit85c0ffa9e1
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 15:57:51 2024 +0200 Update roles/custom/matrix-livekit-server/tasks/uninstall.yml Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commitb691f39d39
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 15:57:44 2024 +0200 Update roles/custom/matrix-livekit-server/tasks/install.yml Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commit10df145101
Author: Slavi Pantaleev <slavi@devture.com> Date: Thu Nov 21 15:57:31 2024 +0200 Update roles/custom/matrix-livekit-server/tasks/install.yml Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com> commitfa2a913d39
Author: wjbeckett <wjbeckett@gmail.com> Date: Thu Oct 3 16:20:54 2024 +1000 fixing issue with element call domain not being expanded when writing the element web config.json. commite18b28136c
Author: wjbeckett <wjbeckett@gmail.com> Date: Thu Oct 3 15:28:56 2024 +1000 Updated Element call docs with dependent services and fixed typo. commit1906d61c39
Author: wjbeckett <wjbeckett@gmail.com> Date: Thu Oct 3 13:25:40 2024 +1000 updated traefik label to be in line with the latest change from devture_traefik_ to traefik_ commitb7e0a41134
Merge:a03f5985a
d9a919a4b
Author: Backslash <wjbeckett@gmail.com> Date: Thu Oct 3 13:20:02 2024 +1000 Merge branch 'spantaleev:master' into element-call-integration commita03f5985a5
Author: wjbeckett <wjbeckett@gmail.com> Date: Thu Oct 3 12:38:34 2024 +1000 removed trailing whitespaces commit1e6698cb99
Author: wjbeckett <wjbeckett@gmail.com> Date: Wed Oct 2 13:27:02 2024 +1000 updated documentation or the new roles. commitf684719b2a
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 22:30:09 2024 +1000 fixed error with element client update task commita6e3203398
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 22:20:50 2024 +1000 updated docs, broke the well-known and element client modifications out to separate tasks. commit2b4fdea70f
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 17:04:11 2024 +1000 added header flags back in. commit6c8923ae28
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 16:51:06 2024 +1000 removed headers. commit9691577b22
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 16:45:07 2024 +1000 removed additinoal headers commit46109565e1
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 16:33:48 2024 +1000 updated headers for each of the call services. commit4acb025130
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 13:35:53 2024 +1000 testing livekit configuration commite421852af5
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 13:09:00 2024 +1000 updated jwt bind port commit5507fb3bab
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 13:08:21 2024 +1000 added element-call config.json to systemd file commit9864996aad
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 12:46:37 2024 +1000 adjusted jwt service ports for traefik commitdbbaae4fbe
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 12:34:25 2024 +1000 stopping the recursive loop commitd53c2428b8
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 12:29:35 2024 +1000 updated jwt hostname. commitf98a505df8
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 11:00:56 2024 +1000 changed jwt-service port label. commitd5aabc85be
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 10:41:30 2024 +1000 removed redis images in favor of the inbuilt keyDB commit7cdec5f251
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 10:17:34 2024 +1000 fixed type in livekit image commitfd2f505b34
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 10:00:30 2024 +1000 Fixed typo in livekit server hostname commit812b57cfaa
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 09:54:02 2024 +1000 resolved missing key. commitb7b8ed573b
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 09:48:44 2024 +1000 typo in livekit-server validate. commit97f93ebd76
Author: wjbeckett <wjbeckett@gmail.com> Date: Tue Oct 1 09:31:42 2024 +1000 renamed the livekit role and added livekit-server and jwt-service roles to the setup file. commit8cb7deff15
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 23:04:10 2024 +1000 cleaned up old services again commit71dff50a65
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 22:53:21 2024 +1000 fixed livekit service name commit58a9642e8c
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 22:45:56 2024 +1000 fixed config file placement. commit3de399025f
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 22:41:36 2024 +1000 hard coded redis port. commite952ba1c3a
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 22:35:59 2024 +1000 removed duplicate tasks. commit8cb3e33bbf
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 22:20:46 2024 +1000 separated livekit and jwt to separate roles commitb907777ae5
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 13:13:29 2024 +1000 fixing labels again. commitcb41fb02ae
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 13:00:10 2024 +1000 testing traefik labels again. commit31a138a6ba
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 12:47:42 2024 +1000 fixed traefik router issues. commit6143ad7ffa
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 12:27:04 2024 +1000 fix: removed the read-only tag from the element-call systemd file. commitf762048a8d
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 12:15:27 2024 +1000 fix: added missing labels to main. commit93650cf20e
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 12:02:45 2024 +1000 fix: Type in the element-call main.yml commit9dbee212d8
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 11:37:08 2024 +1000 fix: removed duplicate keys. commit1167e1ec13
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 11:17:34 2024 +1000 fix: changed matrix server name to matrix domain in element-call config. commitf036e18789
Author: wjbeckett <wjbeckett@gmail.com> Date: Mon Sep 30 11:05:11 2024 +1000 Fix: Restructured Element call configuration files. commita274d32c6d
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 12:50:31 2024 +1000 Removed serve function commit5db9a5c061
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 12:40:37 2024 +1000 Removed env file commit2492672025
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 12:39:39 2024 +1000 Update env.j2 commita0917fa283
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 12:37:36 2024 +1000 Update main.yml commit8b172cc194
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 12:35:38 2024 +1000 Update env.j2 commit63133d6599
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 11:53:26 2024 +1000 Added serve command back in. commit5b8dcf32d5
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 11:42:34 2024 +1000 Added element-call systemd services to the service manager. commit14614cb211
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 10:26:01 2024 +1000 Update matrix-element-call.service.j2 commit3c084e17d2
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 10:15:51 2024 +1000 Update element-call-labels.j2-new commit089c5f14c8
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 10:00:40 2024 +1000 Update jwt-service-labels.j2 commitb6571fc4fd
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 09:59:54 2024 +1000 Update livekit-labels.j2 commit6d6f9ab853
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 09:59:13 2024 +1000 Added hostnames for livekit and jwt labels commit5730dbfc6e
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 09:54:01 2024 +1000 Added hostname label commitc14f9cdcb5
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 09:25:48 2024 +1000 Update matrix_servers commit805b726c6d
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 09:25:01 2024 +1000 Update element-call-labels.j2 commit5f49433f6c
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 09:15:21 2024 +1000 Handle empty labels correctly. commit510cfb2dac
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 09:14:29 2024 +1000 Update matrix_servers commit1721e85195
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 09:00:03 2024 +1000 Corrected element call labels file name commit25909b1029
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 08:51:27 2024 +1000 Update and rename labels.j2 to element-call-labels.j2 commit3264408758
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 08:49:55 2024 +1000 Rename element-call-labels.j2 to element-call-labels.j2-new commitdd96b93d89
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 08:34:01 2024 +1000 Update matrix-element-call.service.j2 commitdf4bf4a0c9
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 08:23:24 2024 +1000 Added tasks for moving the new labels files into place commit2f2cb8962e
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 08:19:26 2024 +1000 Updated livekit labels commitd2e2781d3b
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 08:18:27 2024 +1000 Updated label file commit80763804f9
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 08:16:56 2024 +1000 Updated label file commit1d7a60055c
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 08:10:06 2024 +1000 Create jwt-service-labels.j2 commit2cf471075d
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 08:09:32 2024 +1000 Created livekit-labels.j2 commit6a519bb053
Author: Backslash <wjbeckett@gmail.com> Date: Fri Sep 27 08:08:42 2024 +1000 Created element-call-labels to separate the labels for each container commitf0632b20eb
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 21:24:43 2024 +1000 Added missing labels for sfu and jwt commit5cc9c70ba6
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 20:57:47 2024 +1000 Remove serve command from matrix-element-call.service.j2 commite34e5da9a4
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 19:57:39 2024 +1000 Update matrix-redis.service.j2 commit656d4275bc
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 19:48:06 2024 +1000 Update install.yml commit6ef304b118
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 19:43:22 2024 +1000 Update validate_config.yml commit85be68946c
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 19:30:15 2024 +1000 Migrated from matrix_redis to redis_ commit3f6c327da2
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 19:18:47 2024 +1000 Update main.yml commitba54e549c4
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 19:08:09 2024 +1000 Added well-known element directory commitf2acc7430d
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 18:53:49 2024 +1000 Create well_known_element.json.j2 commit9cb236da30
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 18:50:48 2024 +1000 Update install.yml commitf38d6a0d88
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 18:39:03 2024 +1000 Update main.yml commitac1295ac45
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 18:33:22 2024 +1000 Create matrix-jwt-service.service.j2 commitbc2ed60762
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 17:23:03 2024 +1000 Update main.yml commitf7621283fd
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 16:31:23 2024 +1000 Update labels.j2 commite31e688a41
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 15:42:05 2024 +1000 Update main.yml commita533ec4204
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 15:38:12 2024 +1000 Update matrix_servers commitf16ca24408
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 15:17:15 2024 +1000 Update install.yml commite910d09ff1
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 14:52:30 2024 +1000 Create matrix-redis.service.j2 commitbc9658c06b
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 13:40:38 2024 +1000 Create matrix-livekit.service.j2 commit45c8a61f04
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 11:39:33 2024 +1000 Migrating to systemd for container management commit954d46cfd7
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 09:25:49 2024 +1000 Update labels.j2 commitdfeca192ab
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 09:23:26 2024 +1000 Update redis.conf.j2 commitf306a47b83
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 09:22:29 2024 +1000 Update livekit.yaml.j2 commitbecdb0810c
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 09:18:55 2024 +1000 Update config.json.j2 commit37fd2e701d
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 09:15:07 2024 +1000 Update env.j2 to support the new configuration commit68cc1f4b2b
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 08:29:16 2024 +1000 Simplified the validation step. commit5efc189293
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 08:12:06 2024 +1000 Updated to support new structure commit02479e8bec
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 07:59:09 2024 +1000 Updated with new structure. commit0eef094f2b
Author: Backslash <wjbeckett@gmail.com> Date: Thu Sep 26 06:51:36 2024 +1000 Restructure install.yml to follow other roles more closely commit16ed788b3f
Author: Backslash <wjbeckett@gmail.com> Date: Wed Sep 25 21:07:22 2024 +1000 Update main.yml commit6364101410
Author: Backslash <wjbeckett@gmail.com> Date: Wed Sep 25 20:20:20 2024 +1000 Adding another debug task for testing the labels file. commit81735503f8
Author: Backslash <wjbeckett@gmail.com> Date: Wed Sep 25 20:06:27 2024 +1000 Added debug task to test labels configuration commit8644a7383e
Author: Backslash <wjbeckett@gmail.com> Date: Wed Sep 25 19:22:21 2024 +1000 Removed additional label loop commitce827e7953
Author: Backslash <wjbeckett@gmail.com> Date: Wed Sep 25 19:09:13 2024 +1000 Changed matrix_base_domain to matrix_domain commitc93d30bcb8
Author: Backslash <wjbeckett@gmail.com> Date: Wed Sep 25 19:07:03 2024 +1000 Added matrix_server_name to the defaults commit90ea758c3b
Author: Backslash <wjbeckett@gmail.com> Date: Wed Sep 25 18:39:26 2024 +1000 Fixed regex for checking the hostname. commit350d4d4bcd
Author: Backslash <wjbeckett@gmail.com> Date: Wed Sep 25 18:35:09 2024 +1000 Fixed assertion block to remove jinja2 delimiters commitfc6357a089
Author: Backslash <wjbeckett@gmail.com> Date: Wed Sep 25 18:05:34 2024 +1000 Update main.yml commit60f34cd7af
Author: wjbeckett <wjbeckett@gmail.com> Date: Wed Sep 25 16:13:29 2024 +1000 fixed matrix_redis for migration commitd1ba784dde
Author: wjbeckett <wjbeckett@gmail.com> Date: Wed Sep 25 15:01:53 2024 +1000 added doc for setting up element call. commit434157eb98
Merge:6594cce57
f657273cc
Author: Backslash <wjbeckett@gmail.com> Date: Wed Sep 25 14:55:42 2024 +1000 Merge branch 'spantaleev:master' into element-call-integration commit6594cce570
Author: wjbeckett <wjbeckett@gmail.com> Date: Wed Sep 25 14:53:48 2024 +1000 Feat: Added element call setup and configuration.
187 lines
23 KiB
Markdown
187 lines
23 KiB
Markdown
<!--
|
|
SPDX-FileCopyrightText: 2021 - 2022 Aaron Raimist
|
|
SPDX-FileCopyrightText: 2021 - 2024 MDAD project contributors
|
|
SPDX-FileCopyrightText: 2021 - 2025 Slavi Pantaleev
|
|
SPDX-FileCopyrightText: 2021 Cody Neiman
|
|
SPDX-FileCopyrightText: 2021 Dan Arnfield
|
|
SPDX-FileCopyrightText: 2021 Marcus Proest
|
|
SPDX-FileCopyrightText: 2021 Matthew Cengia
|
|
SPDX-FileCopyrightText: 2022 Cody Wyatt Neiman
|
|
SPDX-FileCopyrightText: 2022 Julian Foad
|
|
SPDX-FileCopyrightText: 2022 Julian-Samuel Gebühr
|
|
SPDX-FileCopyrightText: 2023 Shreyas Ajjarapu
|
|
SPDX-FileCopyrightText: 2024 - 2025 Suguru Hirahara
|
|
|
|
SPDX-License-Identifier: AGPL-3.0-or-later
|
|
-->
|
|
|
|
# Container images used by the playbook
|
|
|
|
This page summarizes the container ([Docker](https://www.docker.com/)) images used by the playbook when setting up your server.
|
|
|
|
We try to stick to official images (provided by their respective projects) as much as possible.
|
|
|
|
## Homeserver
|
|
|
|
| Service | Container image | Default? | Description |
|
|
| ------- | --------------- | -------- | ----------- |
|
|
| [Synapse](configuring-playbook-synapse.md) | [element-hq/synapse](https://ghcr.io/element-hq/synapse) | ✅ | Storing your data and managing your presence in the [Matrix](http://matrix.org/) network |
|
|
| [Conduit](configuring-playbook-conduit.md) | [matrixconduit/matrix-conduit](https://hub.docker.com/r/matrixconduit/matrix-conduit) | ❌ | 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 |
|
|
| [conduwuit](configuring-playbook-conduwuit.md) | [girlbossceo/conduwuit](https://ghcr.io/girlbossceo/conduwuit) | ❌ | Storing your data and managing your presence in the [Matrix](http://matrix.org/) network. conduwuit is a fork of Conduit. |
|
|
| [Dendrite](configuring-playbook-dendrite.md) | [matrixdotorg/dendrite-monolith](https://hub.docker.com/r/matrixdotorg/dendrite-monolith/) | ❌ | 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. |
|
|
|
|
## Clients
|
|
|
|
Web clients for Matrix that you can host on your own domains.
|
|
|
|
| Service | Container image | Default? | Description |
|
|
| ------- | --------------- | -------- | ----------- |
|
|
| [Element Web](configuring-playbook-client-element-web.md) | [vectorim/element-web](https://hub.docker.com/r/vectorim/element-web/) | ✅ | Default Matrix web client, configured to connect to your own Synapse server |
|
|
| [Hydrogen](configuring-playbook-client-hydrogen.md) | [element-hq/hydrogen-web](https://ghcr.io/element-hq/hydrogen-web) | ❌ | Lightweight Matrix client with legacy and mobile browser support |
|
|
| [Cinny](configuring-playbook-client-cinny.md) | [ajbura/cinny](https://hub.docker.com/r/ajbura/cinny) | ❌ | Simple, elegant and secure web client |
|
|
| [SchildiChat Web](configuring-playbook-client-schildichat-web.md) | [etke.cc/schildichat-web](https://ghcr.io/etkecc/schildichat-web) | ❌ | Based on Element Web, with a more traditional instant messaging experience |
|
|
|
|
## Server Components
|
|
|
|
Services that run on the server to make the various parts of your installation work.
|
|
|
|
| Service | Container image | Default? | Description |
|
|
| ------- | --------------- | -------- | ----------- |
|
|
| [PostgreSQL](configuring-playbook-external-postgres.md) | [postgres](https://hub.docker.com/_/postgres/) | ✅ | Database for Synapse. [Using an external PostgreSQL server](configuring-playbook-external-postgres.md) is also possible. |
|
|
| [coturn](configuring-playbook-turn.md) | [coturn/coturn](https://hub.docker.com/r/coturn/coturn/) | ✅ | STUN/TURN server for WebRTC audio/video calls |
|
|
| [Traefik](configuring-playbook-traefik.md) | [Traefik](https://hub.docker.com/_/traefik/) | ✅ | Web server, listening on ports 80, 443 and 8448 — standing in front of all the other services. [Using your own webserver](configuring-playbook-own-webserver.md) is also possible. |
|
|
| [Let's Encrypt](configuring-playbook-ssl-certificates.md) | [certbot/certbot](https://hub.docker.com/r/certbot/certbot/) | ✅ | [Certbot](https://certbot.eff.org/) tool for obtaining SSL certificates from [Let's Encrypt](https://letsencrypt.org/) |
|
|
| [Exim](configuring-playbook-email.md) | [devture/exim-relay](https://hub.docker.com/r/devture/exim-relay/) | ✅ | Mail server, through which all Matrix services send outgoing email (can be configured to relay through another SMTP server) |
|
|
| [ma1sd](configuring-playbook-ma1sd.md) | [ma1uta/ma1sd](https://hub.docker.com/r/ma1uta/ma1sd/) | ❌ | Matrix Identity Server |
|
|
| [ddclient](configuring-playbook-dynamic-dns.md) | [linuxserver/ddclient](https://hub.docker.com/r/linuxserver/ddclient) | ❌ | Update dynamic DNS entries for accounts on Dynamic DNS Network Service Provider |
|
|
| [LiveKit Server](configuring-playbook-livekit-server.md) | [livekit/livekit-server](https://hub.docker.com/r/livekit/livekit-server/) | ❌ | WebRTC server for audio/video calls |
|
|
| [Livekit JWT Service](configuring-playbook-livekit-jwt-service.md) | [element-hq/lk-jwt-service](https://ghcr.io/element-hq/lk-jwt-service) | ❌ | JWT service for integrating [Element Call](./configuring-playbook-element-call.md) with [LiveKit Server](./configuring-playbook-livekit-server.md) |
|
|
|
|
## Authentication
|
|
|
|
Extend and modify how users are authenticated on your homeserver.
|
|
|
|
| Service | Container image | Default? | Description |
|
|
| ------- | --------------- | -------- | ----------- |
|
|
| [matrix-synapse-rest-auth](configuring-playbook-rest-auth.md) | (N/A) | ❌ | REST authentication password provider module |
|
|
| [matrix-synapse-shared-secret-auth](configuring-playbook-shared-secret-auth.md) | (N/A) | ❌ | Password provider module |
|
|
| [matrix-synapse-ldap3](configuring-playbook-ldap-auth.md) (advanced) | (N/A) | ❌ | LDAP Auth password provider module |
|
|
| [matrix-ldap-registration-proxy](configuring-playbook-matrix-ldap-registration-proxy.md) | [activism.international/matrix_ldap_registration_proxy](https://gitlab.com/activism.international/matrix_ldap_registration_proxy/container_registry) | ❌ | Proxy that handles Matrix registration requests and forwards them to LDAP |
|
|
| [matrix-registration](configuring-playbook-matrix-registration.md) | [zeratax/matrix-registration](https://hub.docker.com/r/devture/zeratax-matrix-registration/) | ❌ | Simple python application to have a token based Matrix registration |
|
|
| [Matrix User Verification Service](configuring-playbook-user-verification-service.md) | [matrixdotorg/matrix-user-verification-service](https://hub.docker.com/r/atrixdotorg/matrix-user-verification-service) | ❌ | Service to verify details of a user based on an Open ID token |
|
|
| [synapse-simple-antispam](configuring-playbook-synapse-simple-antispam.md) (advanced) | (N/A) | ❌ | Spam checker module |
|
|
|
|
## File Storage
|
|
|
|
Use alternative file storage to the default `media_store` folder.
|
|
|
|
| Service | Container image | Default? | Description |
|
|
| ------- | --------------- | -------- | ----------- |
|
|
| [Goofys](configuring-playbook-s3-goofys.md) | [ewoutp/goofys](https://hub.docker.com/r/ewoutp/goofys/) | ❌ | [Amazon S3](https://aws.amazon.com/s3/) (or other S3-compatible object store) storage for Synapse's content repository (`media_store`) files |
|
|
| [synapse-s3-storage-provider](configuring-playbook-s3.md) | (N/A) | ❌ | [Amazon S3](https://aws.amazon.com/s3/) (or other S3-compatible object store) storage for Synapse's content repository (`media_store`) files |
|
|
| [matrix-media-repo](configuring-playbook-matrix-media-repo.md) | [t2bot/matrix-media-repo](https://ghcr.io/t2bot/matrix-media-repo) | ❌ | 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. |
|
|
|
|
# Bridges
|
|
|
|
Bridges can be used to connect your Matrix installation with third-party communication networks.
|
|
|
|
| Service | Container image | Default? | Description |
|
|
| ------- | --------------- | -------- | ----------- |
|
|
| [mautrix-bluesky](configuring-playbook-bridge-mautrix-bluesky.md) | [mautrix/bluesky](https://mau.dev/mautrix/bluesky/container_registry) | ❌ | Bridge to [Bluesky](https://bsky.social/about) |
|
|
| [mautrix-discord](configuring-playbook-bridge-mautrix-discord.md) | [mautrix/discord](https://mau.dev/mautrix/discord/container_registry) | ❌ | Bridge to [Discord](https://discord.com/) |
|
|
| [mautrix-slack](configuring-playbook-bridge-mautrix-slack.md) | [mautrix/slack](https://mau.dev/mautrix/slack/container_registry) | ❌ | Bridge to [Slack](https://slack.com/) |
|
|
| [mautrix-telegram](configuring-playbook-bridge-mautrix-telegram.md) | [mautrix/telegram](https://mau.dev/mautrix/telegram/container_registry) | ❌ | Bridge to [Telegram](https://telegram.org/) |
|
|
| [mautrix-gmessages](configuring-playbook-bridge-mautrix-gmessages.md) | [mautrix/gmessages](https://mau.dev/mautrix/gmessages/container_registry) | ❌ | Bridge to [Google Messages](https://messages.google.com/) |
|
|
| [mautrix-whatsapp](configuring-playbook-bridge-mautrix-whatsapp.md) | [mautrix/whatsapp](https://mau.dev/mautrix/whatsapp/container_registry) | ❌ | Bridge to [WhatsApp](https://www.whatsapp.com/) |
|
|
| [mautrix-wsproxy](configuring-playbook-bridge-mautrix-wsproxy.md) | [mautrix/wsproxy](https://mau.dev/mautrix/wsproxy/container_registry) | ❌ | Bridge to Android SMS or Apple iMessage |
|
|
| [mautrix-twitter](configuring-playbook-bridge-mautrix-twitter.md) | [mautrix/twitter](https://mau.dev/mautrix/twitter/container_registry) | ❌ | Bridge to [Twitter](https://twitter.com/) |
|
|
| [mautrix-googlechat](configuring-playbook-bridge-mautrix-googlechat.md) | [mautrix/googlechat](https://mau.dev/mautrix/googlechat/container_registry) | ❌ | Bridge to [Google Chat](https://en.wikipedia.org/wiki/Google_Chat) |
|
|
| mautrix-meta (for [Messenger](configuring-playbook-bridge-mautrix-meta-messenger.md) and [Instagram](configuring-playbook-bridge-mautrix-meta-instagram.md)) | [mautrix/meta](https://mau.dev/mautrix/meta/container_registry) | ❌ | Bridge to [Messenger](https://messenger.com/) and [Instagram](https://instagram.com/) |
|
|
| [mautrix-signal](configuring-playbook-bridge-mautrix-signal.md) | [mautrix/signal](https://mau.dev/mautrix/signal/container_registry) | ❌ | Bridge to [Signal](https://www.signal.org/) |
|
|
| [beeper-linkedin](configuring-playbook-bridge-beeper-linkedin.md) | [beeper/linkedin](https://ghcr.io/beeper/linkedin) | ❌ | Bridge to [LinkedIn](https://www.linkedin.com/) |
|
|
| [matrix-appservice-irc](configuring-playbook-bridge-appservice-irc.md) | [matrixdotorg/matrix-appservice-irc](https://hub.docker.com/r/matrixdotorg/matrix-appservice-irc) | ❌ | Bridge to [IRC](https://wikipedia.org/wiki/Internet_Relay_Chat) |
|
|
| [matrix-appservice-kakaotalk](configuring-playbook-bridge-appservice-kakaotalk.md) | Self-building | ❌ | Bridge to [Kakaotalk](https://www.kakaocorp.com/page/service/service/KakaoTalk?lang=ENG) |
|
|
| [matrix-appservice-discord](configuring-playbook-bridge-appservice-discord.md) | [matrix-org/matrix-appservice-discord](https://ghcr.io/matrix-org/matrix-appservice-discord) | ❌ | Bridge to [Discord](https://discordapp.com/) |
|
|
| [matrix-appservice-slack](configuring-playbook-bridge-appservice-slack.md) | [matrixdotorg/matrix-appservice-slack](https://hub.docker.com/r/matrixdotorg/matrix-appservice-slack) | ❌ | Bridge to [Slack](https://slack.com/) |
|
|
| [matrix-hookshot](configuring-playbook-bridge-hookshot.md) | [halfshot/matrix-hookshot](https://hub.docker.com/r/halfshot/matrix-hookshot) | ❌ | Bridge for generic webhooks and multiple project management services, such as GitHub, GitLab, Figma, and Jira in particular |
|
|
| [matrix-sms-bridge](configuring-playbook-bridge-matrix-bridge-sms.md) | [folivonet/matrix-sms-bridge](https://hub.docker.com/repository/docker/folivonet/matrix-sms-bridge) | ❌ | Bridge to SMS |
|
|
| [matrix-wechat](configuring-playbook-bridge-wechat.md) | [lxduo/matrix-wechat](https://hub.docker.com/r/lxduo/matrix-wechat) | ❌ | Bridge to [WeChat](https://www.wechat.com/) |
|
|
| [Heisenbridge](configuring-playbook-bridge-heisenbridge.md) | [hif1/heisenbridge](https://hub.docker.com/r/hif1/heisenbridge) | ❌ | Bouncer-style bridge to [IRC](https://wikipedia.org/wiki/Internet_Relay_Chat) |
|
|
| [go-skype-bridge](configuring-playbook-bridge-go-skype-bridge.md) | [nodefyme/go-skype-bridge](https://hub.docker.com/r/nodefyme/go-skype-bridge) | ❌ | Bridge to [Skype](https://www.skype.com) |
|
|
| [mx-puppet-slack](configuring-playbook-bridge-mx-puppet-slack.md) | [mx-puppet/slack/mx-puppet-slack](https://gitlab.com/mx-puppet/slack/mx-puppet-slack/container_registry) | ❌ | Bridge to [Slack](https://slack.com) |
|
|
| [mx-puppet-instagram](configuring-playbook-bridge-mx-puppet-instagram.md) | [sorunome/mx-puppet-instagram](https://hub.docker.com/r/sorunome/mx-puppet-instagram) | ❌ | Bridge for Instagram-DMs ([Instagram](https://www.instagram.com/)) |
|
|
| [mx-puppet-twitter](configuring-playbook-bridge-mx-puppet-twitter.md) | [sorunome/mx-puppet-twitter](https://hub.docker.com/r/sorunome/mx-puppet-twitter) | ❌ | Bridge for Twitter-DMs ([Twitter](https://twitter.com/)) |
|
|
| [mx-puppet-discord](configuring-playbook-bridge-mx-puppet-discord.md) | [mx-puppet/discord/mx-puppet-discord](https://gitlab.com/mx-puppet/discord/mx-puppet-discord/container_registry) | ❌ | Bridge to [Discord](https://discordapp.com/) |
|
|
| [mx-puppet-groupme](configuring-playbook-bridge-mx-puppet-groupme.md) | [xangelix/mx-puppet-groupme](https://hub.docker.com/r/xangelix/mx-puppet-groupme) | ❌ | Bridge to [GroupMe](https://groupme.com/) |
|
|
| [mx-puppet-steam](configuring-playbook-bridge-mx-puppet-steam.md) | [icewind1991/mx-puppet-steam](https://hub.docker.com/r/icewind1991/mx-puppet-steam) | ❌ | Bridge to [Steam](https://steamapp.com/) |
|
|
| [Postmoogle](configuring-playbook-bridge-postmoogle.md) | [etke.cc/postmoogle](https://github.com/etkecc/postmoogle/container_registry) | ❌ | Email to Matrix bridge |
|
|
|
|
## Bots
|
|
|
|
Bots provide various additional functionality to your installation.
|
|
|
|
| Service | Container image | Default? | Description |
|
|
| ------- | --------------- | -------- | ----------- |
|
|
| [baibot](configuring-playbook-bot-baibot.md) | [etke.cc/baibot](https://ghcr.io/etkecc/baibot) | ❌ | 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 |
|
|
| [matrix-reminder-bot](configuring-playbook-bot-matrix-reminder-bot.md) | [anoa/matrix-reminder-bot](https://hub.docker.com/r/anoa/matrix-reminder-bot) | ❌ | Bot for scheduling one-off & recurring reminders and alarms |
|
|
| [matrix-registration-bot](configuring-playbook-bot-matrix-registration-bot.md) | [moanos/matrix-registration-bot](https://hub.docker.com/r/moanos/matrix-registration-bot/) | ❌ | Bot for invitations by creating and managing registration tokens |
|
|
| [maubot](configuring-playbook-bot-maubot.md) | [dock.mau.dev/maubot/maubot](https://mau.dev/maubot/maubot/container_registry) | ❌ | Plugin-based Matrix bot system |
|
|
| [Honoroit](configuring-playbook-bot-honoroit.md) | [etke.cc/honoroit](https://github.com/etkecc/honoroit/container_registry) | ❌ | Helpdesk bot |
|
|
| [Mjolnir](configuring-playbook-bot-mjolnir.md) | [matrixdotorg/mjolnir](https://hub.docker.com/r/matrixdotorg/mjolnir) | ❌ | Moderation tool for Matrix |
|
|
| [Draupnir](configuring-playbook-bot-draupnir.md) | [gnuxie/draupnir](https://hub.docker.com/r/gnuxie/draupnir) | ❌ | Moderation tool for Matrix (Fork of Mjolnir) |
|
|
| [Buscarron](configuring-playbook-bot-buscarron.md) | [etke.cc/buscarron](https://ghcr.io/etkecc/buscarron) | ❌ | Web forms (HTTP POST) to Matrix |
|
|
|
|
## Administration
|
|
|
|
Services that help you in administrating and monitoring your Matrix installation.
|
|
|
|
| Service | Container image | Default? | Description |
|
|
| ------- | --------------- | -------- | ----------- |
|
|
| [matrix-alertmanager-receiver](configuring-playbook-alertmanager-receiver.md) | [metio/matrix-alertmanager-receiver](https://hub.docker.com/r/metio/matrix-alertmanager-receiver) | ❌ | Prometheus' [Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/) client |
|
|
| [Matrix Authentication Service](configuring-playbook-matrix-authentication-service.md) | [element-hq/matrix-authentication-service](https://ghcr.io/element-hq/matrix-authentication-service) | ❌ | OAuth 2.0 and OpenID Provider server |
|
|
| [synapse-admin](configuring-playbook-synapse-admin.md) | [etke.cc/synapse-admin](https://ghcr.io/etkecc/synapse-admin) | ❌ | Web UI tool for administrating users and rooms on your Matrix server |
|
|
| [Metrics and Graphs](configuring-playbook-prometheus-grafana.md) | [prom/prometheus](https://hub.docker.com/r/prom/prometheus/) | ❌ | [Prometheus](https://prometheus.io) time-series database server |
|
|
| [Metrics and Graphs](configuring-playbook-prometheus-grafana.md) | [prom/node-exporter](https://hub.docker.com/r/prom/node-exporter/) | ❌ | Prometheus [node-exporter](https://prometheus.io/docs/guides/node-exporter/) host metrics exporter |
|
|
| [Metrics and Graphs](configuring-playbook-prometheus-grafana.md) | [grafana/grafana](https://hub.docker.com/r/grafana/grafana/) | ❌ | Graphing tool that works well with the above two images. Our playbook also adds two dashboards for [Synapse](https://github.com/element-hq/synapse/tree/master/contrib/grafana) and [Node Exporter](https://github.com/rfrail3/grafana-dashboards) |
|
|
| [Metrics and Graphs](configuring-playbook-prometheus-grafana.md#enable-metrics-and-graphs-for-nginx-logs-optional) | [martin-helmich/prometheus-nginxlog-exporter/exporter](https://ghcr.io/martin-helmich/prometheus-nginxlog-exporter/exporter) | ❌ | Addon for Prometheus that gathers access logs from various nginx reverse-proxies |
|
|
| [Borg](configuring-playbook-backup-borg.md) | (N/A) | ❌ | Backups |
|
|
| [postgres-backup-local](configuring-playbook-postgres-backup.md) | [prodrigestivill/postgres-backup-local](https://hub.docker.com/r/prodrigestivill/postgres-backup-local) | ❌ | Create automatic database backups |
|
|
| [rageshake](configuring-playbook-rageshake.md) | [matrix-org/rageshake](https://ghcr.io/matrix-org/rageshake) | ❌ | Bug report server |
|
|
| [synapse-usage-exporter](configuring-playbook-synapse-usage-exporter.md) | Self-building | ❌ | Export the usage statistics of a Synapse homeserver to be scraped by Prometheus. |
|
|
|
|
## Misc
|
|
|
|
Various services that don't fit any other categories.
|
|
|
|
| Service | Container image | Default? | Description |
|
|
| ------- | --------------- | -------- | ----------- |
|
|
| [sliding-sync](configuring-playbook-sliding-sync-proxy.md) | [matrix-org/sliding-sync](https://ghcr.io/matrix-org/sliding-sync) | ❌ | Sliding Sync support for clients which require it (like old Element X versions, before it got switched to Simplified Sliding Sync) |
|
|
| [synapse_auto_accept_invite](configuring-playbook-synapse-auto-accept-invite.md) | (N/A) | ❌ | Synapse module to automatically accept invites |
|
|
| [synapse_auto_compressor](configuring-playbook-synapse-auto-compressor.md) | [etke.cc/rust-synapse-compress-state](https://gitlab.com/etke.cc/rust-synapse-compress-state/container_registry) | ❌ | Cli tool that automatically compresses `state_groups` database table in background |
|
|
| [Matrix Corporal](configuring-playbook-matrix-corporal.md) (advanced) | [devture/matrix-corporal](https://hub.docker.com/r/devture/matrix-corporal/) | ❌ | Reconciliator and gateway for a managed Matrix server |
|
|
| [Etherpad](configuring-playbook-etherpad.md) | [etherpad/etherpad](https://hub.docker.com/r/etherpad/etherpad/) | ❌ | Open source collaborative text editor |
|
|
| [Jitsi](configuring-playbook-jitsi.md) | [jitsi/web](https://hub.docker.com/r/jitsi/web) | ❌ | [Jitsi](https://jitsi.org/) web UI |
|
|
| [Jitsi](configuring-playbook-jitsi.md) | [jitsi/jicofo](https://hub.docker.com/r/jitsi/jicofo) | ❌ | [Jitsi](https://jitsi.org/) Focus component |
|
|
| [Jitsi](configuring-playbook-jitsi.md) | [jitsi/prosody](https://hub.docker.com/r/jitsi/prosody) | ❌ | [Jitsi](https://jitsi.org/) Prosody XMPP server component |
|
|
| [Jitsi](configuring-playbook-jitsi.md) | [jitsi/jvb](https://hub.docker.com/r/jitsi/jvb) | ❌ | [Jitsi](https://jitsi.org/) Video Bridge component |
|
|
| [Cactus Comments](configuring-playbook-cactus-comments.md) | [cactuscomments/cactus-appservice](https://hub.docker.com/r/cactuscomments/cactus-appservice/) | ❌ | Federated comment system built on Matrix |
|
|
| [Cactus Comments](configuring-playbook-cactus-comments.md) | [joseluisq/static-web-server](https://hub.docker.com/r/joseluisq/static-web-server) | ❌ | Federated comment system built on Matrix |
|
|
| [Pantalaimon](configuring-playbook-pantalaimon.md) | [matrixdotorg/pantalaimon](https://hub.docker.com/r/matrixdotorg/pantalaimon) | ❌ | E2EE aware proxy daemon |
|
|
| [Sygnal](configuring-playbook-sygnal.md) | [matrixdotorg/sygnal](https://hub.docker.com/r/matrixdotorg/sygnal/) | ❌ | Reference Push Gateway for Matrix |
|
|
| [ntfy](configuring-playbook-ntfy.md) | [binwiederhier/ntfy](https://hub.docker.com/r/binwiederhier/ntfy/) | ❌ | Self-hosted, UnifiedPush-compatible push notifications server |
|
|
| [Element Call](configuring-playbook-element-call.md) | [element-hq/element-call](https://ghcr.io/element-hq/element-call) | ❌ | A native Matrix video conferencing application |
|
|
|
|
## Container images of deprecated / unmaintained services
|
|
|
|
The list of the deprecated or unmaintained services is available [here](configuring-playbook.md#deprecated--unmaintained--removed-services).
|
|
|
|
| Service | Container image | Default? | Description |
|
|
| ------- | --------------- | -------- | ----------- |
|
|
| [matrix-appservice-webhooks](configuring-playbook-bridge-appservice-webhooks.md) | [turt2live/matrix-appservice-webhooks](https://hub.docker.com/r/turt2live/matrix-appservice-webhooks) | ❌ | Bridge for slack compatible webhooks ([ConcourseCI](https://concourse-ci.org/), [Slack](https://slack.com/) etc. pp.) |
|
|
| [Dimension](configuring-playbook-dimension.md) | [turt2live/matrix-dimension](https://hub.docker.com/r/turt2live/matrix-dimension) | ❌ | Open source integration manager for Matrix clients |
|
|
| [Email2Matrix](configuring-playbook-email2matrix.md) | [devture/email2matrix](https://hub.docker.com/r/devture/email2matrix/) | ❌ | Bridge for relaying emails to Matrix rooms |
|
|
| [Go-NEB](configuring-playbook-bot-go-neb.md) | [matrixdotorg/go-neb](https://hub.docker.com/r/matrixdotorg/go-neb) | ❌ | Multi functional bot written in Go |
|
|
| [matrix-chatgpt-bot](configuring-playbook-bot-chatgpt.md) | [matrixgpt/matrix-chatgpt-bot](https://ghcr.io/matrixgpt/matrix-chatgpt-bot) | ❌ | Accessing ChatGPT via your favourite Matrix client |
|
|
| [mautrix-facebook](configuring-playbook-bridge-mautrix-facebook.md) | [mautrix/facebook](https://mau.dev/mautrix/facebook/container_registry) | ❌ | Bridge to [Facebook](https://facebook.com/) |
|
|
| [mautrix-instagram](configuring-playbook-bridge-mautrix-instagram.md) | [mautrix/instagram](https://mau.dev/mautrix/instagram/container_registry) | ❌ | Bridge to [Instagram](https://instagram.com/) |
|