matrix-docker-ansible-deploy/docs
Slavi Pantaleev df5d8bfc04 Remove matrix-homeserver-proxy role in favor of the new internal Traefik entrypoint
This was meant to serve as an intermediary for services needing to reach
the homeserver. It was used like that for a while in this
`bye-bye-nginx-proxy` branch, but was never actually public.

It has recently been superseded by homeserver-like services injecting
themselves into a new internal Traefik entrypoint
(see `matrix_playbook_internal_matrix_client_api_traefik_entrypoint_*`),
so `matrix-homeserver-proxy` is no longer necessary.

---

This is probably a good moment to share some benchmarks and reasons
for going with the internal Traefik entrypoint as opposed to this nginx
service.

1. (1400 rps) Directly to Synapse (`ab -n 1000 -c 100 http://matrix-synapse:8008/_matrix/client/versions`
2. (~900 rps) Via `matrix-homeserver-proxy` (nginx) proxying to Synapse (`ab -n 1000 -c 100 http://matrix-homeserver-proxy:8008/_matrix/client/versions`)
3. (~1200 rps) Via the new internal entrypoint of Traefik (`matrix-internal-matrix-client-api`) proxying to Synapse (`ab -n 1000 -c 100 http://matrix-traefik:8008/_matrix/client/versions`)

Besides Traefik being quicker for some reason, there are also other
benefits to not having this `matrix-homeserver-proxy` component:

- we can reuse what we have in terms of labels. Services can register a few extra labels on the new Traefik entrypoint
- we don't need services (like `matrix-media-repo`) to inject custom nginx configs into `matrix-homeserver-proxy`. They just need to register labels, like they do already.
- Traefik seems faster than nginx on this benchmark for some reason, which is a nice bonus
- no need to run one extra container (`matrix-homeserver-proxy`) and execute one extra Ansible role
- no need to maintain a setup where some people run the `matrix-homeserver-proxy` component (because they have route-stealing services like `matrix-media-repo` enabled) and others run an optimized setup without this component and everything needs to be rewired to talk to the homeserver directly. Now, everyone can go through Traefik and we can all run an identical setup

Downsides of the new Traefik entrypoint setup are that:

- all addon services that need to talk to the homeserver now depend on Traefik
- people running their own Traefik setup will be inconvenienced - they
  need to manage one additional entrypoint
2024-01-14 10:53:14 +02:00
..
assets
alternative-architectures.md
ansible.md Upgrade devture/ansible (2.14.5-r0-0 -> 2.16.1-r0-0) 2023-12-16 09:59:07 +02:00
configuring-captcha.md
configuring-dns.md refactor: update links to avoid future issue 2023-12-15 11:18:18 +01:00
configuring-playbook-backup-borg.md
configuring-playbook-base-domain-serving.md Add support for serving the base domain via matrix-static-files 2024-01-03 14:39:17 +02:00
configuring-playbook-bot-buscarron.md Fix some typos on the Buscarron docs page 2023-02-25 15:59:28 +02:00
configuring-playbook-bot-chatgpt.md Add system promt variable to docs 2023-07-30 04:50:05 +02:00
configuring-playbook-bot-draupnir.md Make addons communicate with the homeserver via a new internal Traefik entrypoint 2024-01-14 10:48:54 +02:00
configuring-playbook-bot-go-neb.md Make bridges/bots use matrix_addons_homeserver_client_api_url (instead of matrix_homeserver_container_url) 2024-01-07 17:04:23 +02:00
configuring-playbook-bot-honoroit.md Default matrix_bot_honoroit_path_prefix to /honoroit to avoid conflicts with Matrix Client-Server API 2023-05-18 10:10:47 +03:00
configuring-playbook-bot-matrix-registration-bot.md Revert "Auto-generate matrix_bot_matrix_registration_bot_bot_password via group vars" 2024-01-09 10:22:20 +02:00
configuring-playbook-bot-matrix-reminder-bot.md
configuring-playbook-bot-maubot.md
configuring-playbook-bot-mjolnir.md Make addons communicate with the homeserver via a new internal Traefik entrypoint 2024-01-14 10:48:54 +02:00
configuring-playbook-bot-postmoogle.md Fixing typos and rewording 2023-05-30 09:09:24 +03:00
configuring-playbook-bridge-appservice-discord.md Update docs for older appservice bridges to enable legacy authorization (#2841) 2023-08-25 15:53:28 +03:00
configuring-playbook-bridge-appservice-irc.md
configuring-playbook-bridge-appservice-kakaotalk.md
configuring-playbook-bridge-appservice-slack.md
configuring-playbook-bridge-appservice-webhooks.md Update docs for older appservice bridges to enable legacy authorization (#2841) 2023-08-25 15:53:28 +03:00
configuring-playbook-bridge-beeper-linkedin.md Update configuring-playbook-bridge-beeper-linkedin.md 2023-11-06 08:51:50 +01:00
configuring-playbook-bridge-go-skype-bridge.md
configuring-playbook-bridge-heisenbridge.md
configuring-playbook-bridge-hookshot.md Clean up some matrix_nginx_proxy_proxy_matrix_metrics_* references 2024-01-04 12:49:00 +02:00
configuring-playbook-bridge-matrix-bridge-sms.md
configuring-playbook-bridge-mautrix-discord.md
configuring-playbook-bridge-mautrix-facebook.md
configuring-playbook-bridge-mautrix-gmessages.md Announce mautrix-gmessages support 2023-07-21 14:37:05 +03:00
configuring-playbook-bridge-mautrix-googlechat.md
configuring-playbook-bridge-mautrix-hangouts.md
configuring-playbook-bridge-mautrix-instagram.md
configuring-playbook-bridge-mautrix-signal.md doc: check typo 2023-12-18 16:51:35 +01:00
configuring-playbook-bridge-mautrix-slack.md
configuring-playbook-bridge-mautrix-telegram.md
configuring-playbook-bridge-mautrix-twitter.md
configuring-playbook-bridge-mautrix-whatsapp.md Update the whatsapp bot callsign 2023-11-30 19:24:06 +01:00
configuring-playbook-bridge-mautrix-wsproxy.md Add DNS section to wsproxy docs 2023-08-23 15:17:03 +03:00
configuring-playbook-bridge-mx-puppet-discord.md
configuring-playbook-bridge-mx-puppet-groupme.md
configuring-playbook-bridge-mx-puppet-instagram.md
configuring-playbook-bridge-mx-puppet-skype.md
configuring-playbook-bridge-mx-puppet-slack.md
configuring-playbook-bridge-mx-puppet-steam.md
configuring-playbook-bridge-mx-puppet-twitter.md
configuring-playbook-cactus-comments.md Add matrix-cactus-comments-client role 2024-01-09 09:53:01 +02:00
configuring-playbook-client-cinny.md
configuring-playbook-client-element.md refactor: update links to avoid future issue 2023-12-15 11:18:18 +01:00
configuring-playbook-client-hydrogen.md refactor: update links to avoid future issue 2023-12-15 11:18:18 +01:00
configuring-playbook-client-schildichat.md Announce SchildiChat 2023-08-31 13:42:40 +03:00
configuring-playbook-conduit.md Add native Traefik support to matrix-conduit 2024-01-11 08:56:51 +02:00
configuring-playbook-dendrite.md
configuring-playbook-dimension.md Add notes about Dimension being unmaintained 2023-08-16 09:17:37 +03:00
configuring-playbook-dynamic-dns.md
configuring-playbook-email2matrix.md Adjust email2matrix docs with regard to the homeserver container URL 2024-01-13 18:15:15 +02:00
configuring-playbook-email.md Replace matrix-mailer with an external role 2024-01-05 17:54:50 +02:00
configuring-playbook-etherpad.md Remove etherpad-proxy-connect role 2024-01-12 17:22:46 +02:00
configuring-playbook-external-postgres.md
configuring-playbook-federation.md
configuring-playbook-jitsi.md refactor: update links to avoid future issue 2023-12-15 11:18:18 +01:00
configuring-playbook-ldap-auth.md Add support for backup LDAP servers (#2650) 2023-04-19 08:52:03 +03:00
configuring-playbook-ma1sd.md Move matrix-ma1sd to its own container network and add native Traefik support 2024-01-09 15:27:13 +02:00
configuring-playbook-matrix-corporal.md Update aux role documentation, removing old matrix-aux references 2023-05-12 07:01:04 +03:00
configuring-playbook-matrix-ldap-registration-proxy.md Remove matrix_ldap_registration_proxy_container_additional_networks_custom mention in docs 2024-01-09 11:51:46 +02:00
configuring-playbook-matrix-media-repo.md Updated MMR docs with updated fields in main.yaml (#3047) 2023-12-18 11:01:59 +02:00
configuring-playbook-matrix-registration.md
configuring-playbook-mautrix-bridges.md add global bridges relay mode switch 2023-07-21 13:22:05 +03:00
configuring-playbook-nginx.md Make addons communicate with the homeserver via a new internal Traefik entrypoint 2024-01-14 10:48:54 +02:00
configuring-playbook-ntfy.md Update configuring-playbook-ntfy.md 2023-03-22 11:28:34 +02:00
configuring-playbook-own-webserver.md Make addons communicate with the homeserver via a new internal Traefik entrypoint 2024-01-14 10:48:54 +02:00
configuring-playbook-postgres-backup.md Fix variable name typos in docs/configuring-playbook-postgres-backup.md 2023-02-27 17:57:36 +02:00
configuring-playbook-prometheus-grafana.md Update documentation related to variables for prometheus-node-exporter/prometheus-postgres-exporter metrics exposure 2024-01-12 18:04:18 +02:00
configuring-playbook-prometheus-nginxlog.md Remove matrix-homeserver-proxy role in favor of the new internal Traefik entrypoint 2024-01-14 10:53:14 +02:00
configuring-playbook-prometheus-postgres.md Update documentation related to variables for prometheus-node-exporter/prometheus-postgres-exporter metrics exposure 2024-01-12 18:04:18 +02:00
configuring-playbook-rageshake.md
configuring-playbook-rest-auth.md
configuring-playbook-riot-web.md Drop some matrix_nginx_proxy_proxy_riot_compat_* variables 2024-01-03 14:43:45 +02:00
configuring-playbook-s3-goofys.md
configuring-playbook-s3.md Announce matrix-media-repo 2023-07-17 22:38:44 +03:00
configuring-playbook-shared-secret-auth.md
configuring-playbook-sliding-sync-proxy.md refactor: update links to avoid future issue 2023-12-15 11:18:18 +01:00
configuring-playbook-ssl-certificates.md Remove tabs from YAML code snippets 2023-11-15 09:26:20 +02:00
configuring-playbook-sygnal.md Update aux role documentation, removing old matrix-aux references 2023-05-12 07:01:04 +03:00
configuring-playbook-synapse-admin.md Rename label-related variables for homeservers 2024-01-14 10:48:54 +02:00
configuring-playbook-synapse-auto-compressor.md Minor rewording 2023-03-12 09:44:43 +02:00
configuring-playbook-synapse-s3-storage-provider.md Adjust S3 docs section to not be so Wasabi-specific 2023-06-16 09:11:53 +03:00
configuring-playbook-synapse-simple-antispam.md
configuring-playbook-synapse.md Upgrade Postgres (v16.0-5 -> v16.0-6) - adds auto-tuning 2023-10-18 08:24:52 +03:00
configuring-playbook-telemetry.md
configuring-playbook-traefik.md Add Traefik Dashboard warning 2023-03-06 10:28:44 +02:00
configuring-playbook-turn.md Add support for external-IP-address-autodetection to Coturn 2023-10-10 11:10:21 +03:00
configuring-playbook-user-verification-service.md
configuring-playbook.md Remove inventory/ directory tree to allow people to manage it as a git repository (etc.) 2024-01-09 19:08:43 +02:00
configuring-well-known.md Merge branch 'master' into bye-bye-nginx-proxy 2024-01-09 15:38:23 +02:00
container-images.md Added Google Messager Bridge (#2794) 2023-07-21 14:33:52 +03:00
faq.md Replace matrix-mailer with an external role 2024-01-05 17:54:50 +02:00
getting-the-playbook.md
howto-server-delegation.md [WIP] Initial work on matrix-static-files role 2024-01-03 13:05:59 +02:00
howto-srv-server-delegation.md Make addons communicate with the homeserver via a new internal Traefik entrypoint 2024-01-14 10:48:54 +02:00
importing-postgres.md Add note about ANALYZE after Postgres database importing 2023-09-26 17:52:01 +03:00
importing-synapse-media-store.md
importing-synapse-sqlite.md Restore --tags=import-synapse-sqlite-db support 2023-05-02 13:34:42 +03:00
installing.md Fix file name typo 2023-03-15 14:14:35 +02:00
maintenance-and-troubleshooting.md
maintenance-checking-services.md
maintenance-migrating.md Add a small tip to maintenance-migrating.md 2023-08-30 10:00:32 +02:00
maintenance-postgres.md Upgrade Postgres (v16.0-5 -> v16.0-6) - adds auto-tuning 2023-10-18 08:24:52 +03:00
maintenance-synapse.md Make addons communicate with the homeserver via a new internal Traefik entrypoint 2024-01-14 10:48:54 +02:00
maintenance-upgrading-services.md
obtaining-access-tokens.md
prerequisites.md Update prerequisites.md (#3050) 2023-12-18 10:58:28 +02:00
README.md
registering-users.md
self-building.md Move exim-relay service to its own network and connect Synapse & ma1sd to it automatically 2024-01-05 18:10:24 +02:00
uninstalling.md
updating-users-passwords.md