overmind
/
matrix-docker-ansible-deploy
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Fork 0
Code Issues 0 Releases 0 Wiki Activity
Matrix Docker Ansible eploy
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
8904 Commits
12 Branches
1.4 GiB
 
 
Tree: af0dfd99cd
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'af0dfd99cd'
${ noResults }
matrix-docker-ansible-deploy/i18n/translation-templates/docs/configuring-playbook-turn.pot

106 lines
5.1 KiB
Raw Blame History 

  1. # SOME DESCRIPTIVE TITLE.

  2. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community members

  3. # This file is distributed under the same license as the matrix-docker-ansible-deploy package.

  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

  5. #

  6. #, fuzzy

  7. msgid ""

  8. msgstr ""

  9. "Project-Id-Version: matrix-docker-ansible-deploy \n"

  10. "Report-Msgid-Bugs-To: \n"

  11. "POT-Creation-Date: 2024-12-20 07:23+0200\n"

  12. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"

  13. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"

  14. "Language-Team: LANGUAGE <LL@li.org>\n"

  15. "MIME-Version: 1.0\n"

  16. "Content-Type: text/plain; charset=UTF-8\n"

  17. "Content-Transfer-Encoding: 8bit\n"

  18. 

  19. #: ../../../docs/configuring-playbook-turn.md:1

  20. msgid "Adjusting TURN server configuration (optional, advanced)"

  21. msgstr ""

  22. 

  23. #: ../../../docs/configuring-playbook-turn.md:3

  24. msgid "The playbook installs a [Coturn](https://github.com/coturn/coturn) TURN server by default, so that clients can make audio/video calls even from [NAT](https://en.wikipedia.org/wiki/Network_address_translation)-ed networks."

  25. msgstr ""

  26. 

  27. #: ../../../docs/configuring-playbook-turn.md:5

  28. msgid "By default, the Synapse chat server is configured, so that it points to the Coturn TURN server installed by the playbook."

  29. msgstr ""

  30. 

  31. #: ../../../docs/configuring-playbook-turn.md:7

  32. msgid "Disabling Coturn"

  33. msgstr ""

  34. 

  35. #: ../../../docs/configuring-playbook-turn.md:9

  36. msgid "If, for some reason, you'd like to prevent the playbook from installing Coturn, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"

  37. msgstr ""

  38. 

  39. #: ../../../docs/configuring-playbook-turn.md:15

  40. msgid "In that case, Synapse would not point to any Coturn servers and audio/video call functionality may fail."

  41. msgstr ""

  42. 

  43. #: ../../../docs/configuring-playbook-turn.md:17

  44. msgid "Manually defining your public IP"

  45. msgstr ""

  46. 

  47. #: ../../../docs/configuring-playbook-turn.md:19

  48. msgid "In the `hosts` file we explicitly ask for your server's external IP address when defining `ansible_host`, because the same value is used for configuring Coturn."

  49. msgstr ""

  50. 

  51. #: ../../../docs/configuring-playbook-turn.md:21

  52. msgid "If you'd rather use a local IP for `ansible_host`, make sure to set up `matrix_coturn_turn_external_ip_address` replacing `YOUR_PUBLIC_IP` with the pubic IP used by the server."

  53. msgstr ""

  54. 

  55. #: ../../../docs/configuring-playbook-turn.md:27

  56. msgid "If you'd like to rely on external IP address auto-detection (not recommended unless you need it), set `matrix_coturn_turn_external_ip_address` to an empty value. The playbook will automatically contact an [EchoIP](https://github.com/mpolden/echoip)-compatible service (`https://ifconfig.co/json` by default) to determine your server's IP address. This API endpoint is configurable via the `matrix_coturn_turn_external_ip_address_auto_detection_echoip_service_url` variable."

  57. msgstr ""

  58. 

  59. #: ../../../docs/configuring-playbook-turn.md:29

  60. msgid "If your server has multiple external IP addresses, the Coturn role offers a different variable for specifying them:"

  61. msgstr ""

  62. 

  63. #: ../../../docs/configuring-playbook-turn.md:36

  64. msgid "Changing the authentication mechanism"

  65. msgstr ""

  66. 

  67. #: ../../../docs/configuring-playbook-turn.md:38

  68. msgid "The playbook uses the [`auth-secret` authentication method](https://github.com/coturn/coturn/blob/873cabd6a2e5edd7e9cc5662cac3ffe47fe87a8e/README.turnserver#L186-L199) by default, but you may switch to the [`lt-cred-mech` method](https://github.com/coturn/coturn/blob/873cabd6a2e5edd7e9cc5662cac3ffe47fe87a8e/README.turnserver#L178) which [some report](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3191) to be working better."

  69. msgstr ""

  70. 

  71. #: ../../../docs/configuring-playbook-turn.md:40

  72. msgid "To do so, add this override to your configuration:"

  73. msgstr ""

  74. 

  75. #: ../../../docs/configuring-playbook-turn.md:46

  76. msgid "Regardless of the selected authentication method, the playbook generates secrets automatically and passes them to the homeserver and Coturn."

  77. msgstr ""

  78. 

  79. #: ../../../docs/configuring-playbook-turn.md:48

  80. msgid "If you're using [Jitsi](./configuring-playbook-jitsi.md), note that switching to `lt-cred-mech` will remove the integration between Jitsi and your own Coturn server, because Jitsi only seems to support the `auth-secret` authentication method."

  81. msgstr ""

  82. 

  83. #: ../../../docs/configuring-playbook-turn.md:50

  84. msgid "Using your own external Coturn server"

  85. msgstr ""

  86. 

  87. #: ../../../docs/configuring-playbook-turn.md:52

  88. msgid "If you'd like to use another TURN server (be it Coturn or some other one), you can configure the playbook like this:"

  89. msgstr ""

  90. 

  91. #: ../../../docs/configuring-playbook-turn.md:66

  92. msgid "If you have or want to enable [Jitsi](configuring-playbook-jitsi.md), you might want to enable the TURN server there too. If you do not do it, Jitsi will fall back to an upstream service."

  93. msgstr ""

  94. 

  95. #: ../../../docs/configuring-playbook-turn.md:72

  96. msgid "You can put multiple host/port combinations if you like."

  97. msgstr ""

  98. 

  99. #: ../../../docs/configuring-playbook-turn.md:74

  100. msgid "Further variables and configuration options"

  101. msgstr ""

  102. 

  103. #: ../../../docs/configuring-playbook-turn.md:75

  104. msgid "To see all the available configuration options, check roles/custom/matrix-coturn/defaults/main.yml"

  105. msgstr ""