overmind
/
matrix-docker-ansible-deploy
miroir de https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Bifurcation 0
Code Tickets 0 Versions 0 Wiki Activité
Matrix Docker Ansible eploy
Vous ne pouvez pas sélectionner plus de 25 sujets Les noms de sujets doivent commencer par une lettre ou un nombre, peuvent contenir des tirets ('-') et peuvent comporter jusqu'à 35 caractères.
10090 Révisions
12 Branches
241 MiB
 
 
Aborescence: ec00a76b14
Branches Tags
${ item.name }
Créer la branche ${ searchTerm }
de 'ec00a76b14'
${ noResults }
matrix-docker-ansible-deploy/i18n/translation-templates/docs/configuring-playbook-jitsi.pot

502 lignes
23 KiB
Brut Annotations Historique 

  1. # SOME DESCRIPTIVE TITLE.

  2. # Copyright (C) 2018-2025, 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: 2025-01-27 09:54+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-jitsi.md:1

  20. msgid "Setting up the Jitsi video-conferencing platform (optional)"

  21. msgstr ""

  22. 

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

  24. msgid "The playbook can install and configure the [Jitsi](https://jitsi.org/) video-conferencing platform for you."

  25. msgstr ""

  26. 

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

  28. msgid "Jitsi can not only be integrated with Element clients ([Element Web](configuring-playbook-client-element-web.md)/Desktop, Android and iOS) as a widget, but also be used as standalone web app."

  29. msgstr ""

  30. 

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

  32. msgid "See the project's [documentation](https://jitsi.github.io/handbook/) to learn what it does and why it might be useful to you."

  33. msgstr ""

  34. 

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

  36. msgid "**Note**: the configuration by the playbook is similar to the one by [docker-jitsi-meet](https://github.com/jitsi/docker-jitsi-meet). You can refer to the official documentation for Docker deployment [here](https://jitsi.github.io/handbook/docs/devops-guide/devops-guide-docker/)."

  37. msgstr ""

  38. 

  39. #: ../../../docs/configuring-playbook-jitsi.md:11

  40. msgid "Prerequisites"

  41. msgstr ""

  42. 

  43. #: ../../../docs/configuring-playbook-jitsi.md:13

  44. msgid "You may need to open the following ports to your server:"

  45. msgstr ""

  46. 

  47. #: ../../../docs/configuring-playbook-jitsi.md:15

  48. msgid "`4443/tcp` — RTP media fallback over TCP"

  49. msgstr ""

  50. 

  51. #: ../../../docs/configuring-playbook-jitsi.md:16

  52. msgid "`10000/udp` — RTP media over UDP. Depending on your firewall/NAT configuration, incoming RTP packets on port `10000` may have the external IP of your firewall as destination address, due to the usage of STUN in JVB (see [`jitsi_jvb_stun_servers`](https://github.com/mother-of-all-self-hosting/ansible-role-jitsi/blob/main/defaults/main.yml))."

  53. msgstr ""

  54. 

  55. #: ../../../docs/configuring-playbook-jitsi.md:18

  56. msgid "Adjusting DNS records"

  57. msgstr ""

  58. 

  59. #: ../../../docs/configuring-playbook-jitsi.md:20

  60. msgid "By default, this playbook installs Jitsi on the `jitsi.` subdomain (`jitsi.example.com`) and requires you to create a CNAME record for `jitsi`, which targets `matrix.example.com`."

  61. msgstr ""

  62. 

  63. #: ../../../docs/configuring-playbook-jitsi.md:22

  64. msgid "When setting, replace `example.com` with your own."

  65. msgstr ""

  66. 

  67. #: ../../../docs/configuring-playbook-jitsi.md:24

  68. msgid "Adjusting the playbook configuration"

  69. msgstr ""

  70. 

  71. #: ../../../docs/configuring-playbook-jitsi.md:26

  72. msgid "To enable Jitsi, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"

  73. msgstr ""

  74. 

  75. #: ../../../docs/configuring-playbook-jitsi.md:32

  76. msgid "Adjusting the Jitsi URL (optional)"

  77. msgstr ""

  78. 

  79. #: ../../../docs/configuring-playbook-jitsi.md:34

  80. msgid "By tweaking the `jitsi_hostname` variable, you can easily make the service available at a **different hostname** than the default one."

  81. msgstr ""

  82. 

  83. #: ../../../docs/configuring-playbook-jitsi.md:36

  84. msgid "Example additional configuration for your `vars.yml` file:"

  85. msgstr ""

  86. 

  87. #: ../../../docs/configuring-playbook-jitsi.md:43

  88. msgid "After changing the domain, **you may need to adjust your DNS** records to point the Jitsi domain to the Matrix server."

  89. msgstr ""

  90. 

  91. #: ../../../docs/configuring-playbook-jitsi.md:45

  92. msgid "Configure Jitsi authentication and guests mode (optional)"

  93. msgstr ""

  94. 

  95. #: ../../../docs/configuring-playbook-jitsi.md:47

  96. msgid "By default the Jitsi instance does not require for anyone to log in, and is open to use without an account. To control who is allowed to start meetings on your Jitsi instance, you'd need to enable Jitsi's authentication and optionally guests mode."

  97. msgstr ""

  98. 

  99. #: ../../../docs/configuring-playbook-jitsi.md:49

  100. msgid "Authentication type must be one of them: `internal` (default), `jwt`, `matrix` or `ldap`. Currently, only `internal`, `matrix` and `ldap` mechanisms are supported by the [Jitsi role](https://github.com/mother-of-all-self-hosting/ansible-role-jitsi)."

  101. msgstr ""

  102. 

  103. #: ../../../docs/configuring-playbook-jitsi.md:51

  104. msgid "With authentication enabled, all meetings have to be started by a registered user. After the meeting is started by that user, then guests are free to join. If the registered user is not yet present, the guests are put on hold in individual waiting rooms."

  105. msgstr ""

  106. 

  107. #: ../../../docs/configuring-playbook-jitsi.md:53

  108. msgid "**Note**: authentication is not tested by the playbook's self-checks. We therefore recommend that you would make sure by yourself that authentication is configured properly. To test it, start a meeting at `jitsi.example.com` on your browser."

  109. msgstr ""

  110. 

  111. #: ../../../docs/configuring-playbook-jitsi.md:55

  112. msgid "Authenticate using Jitsi accounts: Auth-Type `internal` (recommended)"

  113. msgstr ""

  114. 

  115. #: ../../../docs/configuring-playbook-jitsi.md:57

  116. msgid "The default authentication mechanism is `internal` auth, which requires a Jitsi account to have been configured. This is a recommended method, as it also works in federated rooms."

  117. msgstr ""

  118. 

  119. #: ../../../docs/configuring-playbook-jitsi.md:59

  120. msgid "To enable authentication with a Jitsi account, add the following configuration to your `vars.yml` file. Make sure to replace `USERNAME_…` and `PASSWORD_…` with your own values."

  121. msgstr ""

  122. 

  123. #: ../../../docs/configuring-playbook-jitsi.md:71

  124. msgid "**Note**: as Jitsi account removal function is not integrated into the playbook, these accounts will not be able to be removed from the Prosody server automatically, even if they are removed from your `vars.yml` file subsequently."

  125. msgstr ""

  126. 

  127. #: ../../../docs/configuring-playbook-jitsi.md:73

  128. msgid "Authenticate using Matrix OpenID: Auth-Type `matrix`"

  129. msgstr ""

  130. 

  131. #: ../../../docs/configuring-playbook-jitsi.md:75

  132. msgid "[!WARNING] This breaks the Jitsi instance on federated rooms probably and does not allow sharing conference links with guests."

  133. msgstr ""

  134. 

  135. #: ../../../docs/configuring-playbook-jitsi.md:78

  136. msgid "This authentication method requires [Matrix User Verification Service](https://github.com/matrix-org/matrix-user-verification-service), which can be installed using this [playbook](configuring-playbook-user-verification-service.md). It verifies against Matrix openID, and requires a user-verification-service to run."

  137. msgstr ""

  138. 

  139. #: ../../../docs/configuring-playbook-jitsi.md:80

  140. msgid "To enable authentication with Matrix OpenID, add the following configuration to your `vars.yml` file:"

  141. msgstr ""

  142. 

  143. #: ../../../docs/configuring-playbook-jitsi.md:88

  144. msgid "For more information see also [https://github.com/matrix-org/prosody-mod-auth-matrix-user-verification](https://github.com/matrix-org/prosody-mod-auth-matrix-user-verification)."

  145. msgstr ""

  146. 

  147. #: ../../../docs/configuring-playbook-jitsi.md:90

  148. msgid "Authenticate using LDAP: Auth-Type `ldap`"

  149. msgstr ""

  150. 

  151. #: ../../../docs/configuring-playbook-jitsi.md:92

  152. msgid "To enable authentication with LDAP, add the following configuration to your `vars.yml` file (adapt to your needs):"

  153. msgstr ""

  154. 

  155. #: ../../../docs/configuring-playbook-jitsi.md:112

  156. msgid "For more information refer to the [docker-jitsi-meet](https://github.com/jitsi/docker-jitsi-meet#authentication-using-ldap) and the [saslauthd `LDAP_SASLAUTHD`](https://github.com/winlibs/cyrus-sasl/blob/master/saslauthd/LDAP_SASLAUTHD) documentation."

  157. msgstr ""

  158. 

  159. #: ../../../docs/configuring-playbook-jitsi.md:114

  160. msgid "Configure `JVB_ADVERTISE_IPS` for running behind NAT or on a LAN environment (optional)"

  161. msgstr ""

  162. 

  163. #: ../../../docs/configuring-playbook-jitsi.md:116

  164. msgid "When running Jitsi in a LAN environment, or on the public Internet via NAT, the `JVB_ADVERTISE_IPS` enviornment variable should be set."

  165. msgstr ""

  166. 

  167. #: ../../../docs/configuring-playbook-jitsi.md:118

  168. msgid "This variable allows to control which IP addresses the JVB will advertise for WebRTC media traffic. It is necessary to set it regardless of the use of a reverse proxy, since it's the IP address that will receive the media (audio / video) and not HTTP traffic, hence it's oblivious to the reverse proxy."

  169. msgstr ""

  170. 

  171. #: ../../../docs/configuring-playbook-jitsi.md:120

  172. msgid "If your users are coming in over the Internet (and not over LAN), this will likely be your public IP address. If this is not set up correctly, calls will crash when more than two users join a meeting."

  173. msgstr ""

  174. 

  175. #: ../../../docs/configuring-playbook-jitsi.md:122

  176. msgid "To set the variable, add the following configuration to your `vars.yml` file. Make sure to replace `LOCAL_IP_ADDRESS_OF_THE_HOST_HERE` with a proper value."

  177. msgstr ""

  178. 

  179. #: ../../../docs/configuring-playbook-jitsi.md:129

  180. msgid "Check [the official documentation](https://jitsi.github.io/handbook/docs/devops-guide/devops-guide-docker/#running-behind-nat-or-on-a-lan-environment) for more details about it."

  181. msgstr ""

  182. 

  183. #: ../../../docs/configuring-playbook-jitsi.md:131

  184. msgid "Set a maximum number of participants on a Jitsi conference (optional)"

  185. msgstr ""

  186. 

  187. #: ../../../docs/configuring-playbook-jitsi.md:133

  188. msgid "You can set a maximum number of participants allowed to join a Jitsi conference. By default the number is not specified."

  189. msgstr ""

  190. 

  191. #: ../../../docs/configuring-playbook-jitsi.md:135

  192. msgid "To set it, add the following configuration to your `vars.yml` file (adapt to your needs):"

  193. msgstr ""

  194. 

  195. #: ../../../docs/configuring-playbook-jitsi.md:141

  196. msgid "Enable Gravatar (optional)"

  197. msgstr ""

  198. 

  199. #: ../../../docs/configuring-playbook-jitsi.md:143

  200. msgid "In the default Jisti Meet configuration, `gravatar.com` is enabled as an avatar service."

  201. msgstr ""

  202. 

  203. #: ../../../docs/configuring-playbook-jitsi.md:145

  204. msgid "Since the Element clients send the URL of configured Matrix avatars to the Jitsi instance, our default configuration has disabled the Gravatar service."

  205. msgstr ""

  206. 

  207. #: ../../../docs/configuring-playbook-jitsi.md:147

  208. msgid "To enable the Gravatar service, add the following configuration to your `vars.yml` file:"

  209. msgstr ""

  210. 

  211. #: ../../../docs/configuring-playbook-jitsi.md:153

  212. msgid "[!WARNING] This will result in third party request leaking data to the Gravatar Service (`gravatar.com`, unless configured otherwise). Besides metadata, the Matrix user_id and possibly the room ID (via `referrer` header) will be also sent to the third party."

  213. msgstr ""

  214. 

  215. #: ../../../docs/configuring-playbook-jitsi.md:156

  216. msgid "Fine tune Jitsi (optional)"

  217. msgstr ""

  218. 

  219. #: ../../../docs/configuring-playbook-jitsi.md:158

  220. msgid "If you'd like to have Jitsi save up resources, add the following configuration to your `vars.yml` file (adapt to your needs):"

  221. msgstr ""

  222. 

  223. #: ../../../docs/configuring-playbook-jitsi.md:171

  224. msgid "These configurations:"

  225. msgstr ""

  226. 

  227. #: ../../../docs/configuring-playbook-jitsi.md:173

  228. msgid "**limit the maximum video resolution**, to save up resources on both server and clients"

  229. msgstr ""

  230. 

  231. #: ../../../docs/configuring-playbook-jitsi.md:174

  232. msgid "**suspend unused video layers** until they are requested again, to save up resources on both server and clients. Read more on this feature [here](https://jitsi.org/blog/new-off-stage-layer-suppression-feature/)."

  233. msgstr ""

  234. 

  235. #: ../../../docs/configuring-playbook-jitsi.md:175

  236. msgid "**disable audio levels** to avoid excessive refresh of the client-side page and decrease the CPU consumption involved"

  237. msgstr ""

  238. 

  239. #: ../../../docs/configuring-playbook-jitsi.md:176

  240. msgid "**limit the number of video feeds forwarded to each client**, to save up resources on both server and clients. As clients’ bandwidth and CPU may not bear the load, use this setting to avoid lag and crashes. This feature is available by default on other webconference applications such as Office 365 Teams (the number is limited to 4). Read how it works [here](https://github.com/jitsi/jitsi-videobridge/blob/5ff195985edf46c9399dcf263cb07167f0a2c724/doc/allocation.md)."

  241. msgstr ""

  242. 

  243. #: ../../../docs/configuring-playbook-jitsi.md:178

  244. msgid "Example configurations"

  245. msgstr ""

  246. 

  247. #: ../../../docs/configuring-playbook-jitsi.md:180

  248. msgid "Here is an example set of configurations for running a Jitsi instance with:"

  249. msgstr ""

  250. 

  251. #: ../../../docs/configuring-playbook-jitsi.md:182

  252. msgid "authentication using a Jitsi account (username: `US3RNAME`, password: `passw0rd`)"

  253. msgstr ""

  254. 

  255. #: ../../../docs/configuring-playbook-jitsi.md:183

  256. msgid "guests: allowed"

  257. msgstr ""

  258. 

  259. #: ../../../docs/configuring-playbook-jitsi.md:184

  260. msgid "maximum participants: 6 people"

  261. msgstr ""

  262. 

  263. #: ../../../docs/configuring-playbook-jitsi.md:185

  264. msgid "fine tuning with the configurations presented above"

  265. msgstr ""

  266. 

  267. #: ../../../docs/configuring-playbook-jitsi.md:186

  268. msgid "other miscellaneous options (see the official Jitsi documentation [here](https://jitsi.github.io/handbook/docs/dev-guide/dev-guide-configuration) and [here](https://jitsi.github.io/handbook/docs/user-guide/user-guide-advanced))"

  269. msgstr ""

  270. 

  271. #: ../../../docs/configuring-playbook-jitsi.md:206

  272. msgid "Installing"

  273. msgstr ""

  274. 

  275. #: ../../../docs/configuring-playbook-jitsi.md:208

  276. msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:"

  277. msgstr ""

  278. 

  279. #: ../../../docs/configuring-playbook-jitsi.md:215

  280. msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"

  281. msgstr ""

  282. 

  283. #: ../../../docs/configuring-playbook-jitsi.md:217

  284. msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too."

  285. msgstr ""

  286. 

  287. #: ../../../docs/configuring-playbook-jitsi.md:219

  288. msgid "Usage"

  289. msgstr ""

  290. 

  291. #: ../../../docs/configuring-playbook-jitsi.md:221

  292. msgid "You can use the self-hosted Jitsi server in multiple ways:"

  293. msgstr ""

  294. 

  295. #: ../../../docs/configuring-playbook-jitsi.md:223

  296. msgid "**by adding a widget to a room via Element Web** (the one configured by the playbook at `https://element.example.com`). Just start a voice or a video call in a room containing more than 2 members and that would create a Jitsi widget which utilizes your self-hosted Jitsi server."

  297. msgstr ""

  298. 

  299. #: ../../../docs/configuring-playbook-jitsi.md:225

  300. msgid "**directly (without any Matrix integration)**. Just go to `https://jitsi.example.com`"

  301. msgstr ""

  302. 

  303. #: ../../../docs/configuring-playbook-jitsi.md:227

  304. msgid "Set up additional JVBs for more video-conferences (optional)"

  305. msgstr ""

  306. 

  307. #: ../../../docs/configuring-playbook-jitsi.md:229

  308. msgid "By default, a single JVB ([Jitsi VideoBridge](https://github.com/jitsi/jitsi-videobridge)) is deployed on the same host as the Matrix server. To allow more video-conferences to happen at the same time, you'd need to provision additional JVB services on other hosts."

  309. msgstr ""

  310. 

  311. #: ../../../docs/configuring-playbook-jitsi.md:231

  312. msgid "These settings below will allow you to provision those extra JVB instances. The instances will register themselves with the Prosody service, and be available for Jicofo to route conferences too."

  313. msgstr ""

  314. 

  315. #: ../../../docs/configuring-playbook-jitsi.md:233

  316. msgid "Add the `jitsi_jvb_servers` section on `hosts` file"

  317. msgstr ""

  318. 

  319. #: ../../../docs/configuring-playbook-jitsi.md:235

  320. msgid "For additional JVBs, you'd need to add the section titled `jitsi_jvb_servers` on the ansible `hosts` file with the details of the JVB hosts as below:"

  321. msgstr ""

  322. 

  323. #: ../../../docs/configuring-playbook-jitsi.md:242

  324. msgid "Make sure to replace `jvb-2.example.com` with your hostname for the JVB and `192.168.0.2` with your JVB's external IP address, respectively."

  325. msgstr ""

  326. 

  327. #: ../../../docs/configuring-playbook-jitsi.md:244

  328. msgid "You could add JVB hosts as many as you would like. When doing so, add lines with the details of them."

  329. msgstr ""

  330. 

  331. #: ../../../docs/configuring-playbook-jitsi.md:246

  332. msgid "Prepare `vars.yml` files for additional JVBs"

  333. msgstr ""

  334. 

  335. #: ../../../docs/configuring-playbook-jitsi.md:248

  336. msgid "If the main server is `matrix.example.com` and the additional JVB instance is going to be deployed at `jvb-2.example.com`, the variables for the latter need to be specified on `vars.yml` in its directory (`inventory/host_vars/jvb-2.example.com`)."

  337. msgstr ""

  338. 

  339. #: ../../../docs/configuring-playbook-jitsi.md:250

  340. msgid "Note that most (if not all) variables are common for both servers."

  341. msgstr ""

  342. 

  343. #: ../../../docs/configuring-playbook-jitsi.md:252

  344. msgid "If you are setting up multiple JVB instances, you'd need to create `vars.yml` files for each of them too (`inventory/host_vars/jvb-3.example.com/vars.yml`, for example)."

  345. msgstr ""

  346. 

  347. #: ../../../docs/configuring-playbook-jitsi.md:254

  348. msgid "Set the server ID to each JVB"

  349. msgstr ""

  350. 

  351. #: ../../../docs/configuring-playbook-jitsi.md:256

  352. msgid "Each JVB requires a server ID to be set, so that it will be uniquely identified. The server ID allows Jitsi to keep track of which conferences are on which JVB."

  353. msgstr ""

  354. 

  355. #: ../../../docs/configuring-playbook-jitsi.md:258

  356. msgid "The server ID can be set with the variable `jitsi_jvb_server_id`. It will end up as the `JVB_WS_SERVER_ID` environment variables in the JVB docker container."

  357. msgstr ""

  358. 

  359. #: ../../../docs/configuring-playbook-jitsi.md:260

  360. msgid "To set the server ID to `jvb-2`, add the following configuration to either `hosts` or `vars.yml` files (adapt to your needs)."

  361. msgstr ""

  362. 

  363. #: ../../../docs/configuring-playbook-jitsi.md:262

  364. msgid "On `hosts`:"

  365. msgstr ""

  366. 

  367. #: ../../../docs/configuring-playbook-jitsi.md:264

  368. msgid "Add `jitsi_jvb_server_id=jvb-2` after your JVB's external IP addresses as below:"

  369. msgstr ""

  370. 

  371. #: ../../../docs/configuring-playbook-jitsi.md:272

  372. msgid "On `vars.yml` files:"

  373. msgstr ""

  374. 

  375. #: ../../../docs/configuring-playbook-jitsi.md:278

  376. msgid "Alternatively, you can specify the variable as a parameter to [the ansible command](#run-the-playbook)."

  377. msgstr ""

  378. 

  379. #: ../../../docs/configuring-playbook-jitsi.md:280

  380. msgid "**Note**: the server ID `jvb-1` is reserved for the JVB instance running on the Matrix host, therefore should not be used as the ID of an additional JVB host."

  381. msgstr ""

  382. 

  383. #: ../../../docs/configuring-playbook-jitsi.md:282

  384. msgid "Set colibri WebSocket port"

  385. msgstr ""

  386. 

  387. #: ../../../docs/configuring-playbook-jitsi.md:284

  388. msgid "The additional JVBs will need to expose the colibri WebSocket port."

  389. msgstr ""

  390. 

  391. #: ../../../docs/configuring-playbook-jitsi.md:286

  392. msgid "To expose the port, add the following configuration to your `vars.yml` files:"

  393. msgstr ""

  394. 

  395. #: ../../../docs/configuring-playbook-jitsi.md:292

  396. msgid "Set Prosody XMPP server"

  397. msgstr ""

  398. 

  399. #: ../../../docs/configuring-playbook-jitsi.md:294

  400. msgid "The JVB will also need to know the location of the Prosody XMPP server."

  401. msgstr ""

  402. 

  403. #: ../../../docs/configuring-playbook-jitsi.md:296

  404. msgid "Similar to the server ID (`jitsi_jvb_server_id`), this can be set with the variable for the JVB by using the variable `jitsi_xmpp_server`."

  405. msgstr ""

  406. 

  407. #: ../../../docs/configuring-playbook-jitsi.md:298

  408. msgid "Set the Matrix domain"

  409. msgstr ""

  410. 

  411. #: ../../../docs/configuring-playbook-jitsi.md:300

  412. msgid "The Jitsi Prosody container is deployed on the Matrix server by default, so the value can be set to the Matrix domain. To set the value, add the following configuration to your `vars.yml` files:"

  413. msgstr ""

  414. 

  415. #: ../../../docs/configuring-playbook-jitsi.md:306

  416. msgid "Set an IP address of the Matrix server"

  417. msgstr ""

  418. 

  419. #: ../../../docs/configuring-playbook-jitsi.md:308

  420. msgid "Alternatively, the IP address of the Matrix server can be set. This can be useful if you would like to use a private IP address."

  421. msgstr ""

  422. 

  423. #: ../../../docs/configuring-playbook-jitsi.md:310

  424. msgid "To set the IP address of the Matrix server, add the following configuration to your `vars.yml` files:"

  425. msgstr ""

  426. 

  427. #: ../../../docs/configuring-playbook-jitsi.md:316

  428. msgid "Expose XMPP port"

  429. msgstr ""

  430. 

  431. #: ../../../docs/configuring-playbook-jitsi.md:318

  432. msgid "By default, the Matrix server does not expose the XMPP port (`5222`); only the XMPP container exposes it internally inside the host. This means that the first JVB (which runs on the Matrix server) can reach it but the additional JVBs cannot. Therefore, the XMPP server needs to expose the port, so that the additional JVBs can connect to it."

  433. msgstr ""

  434. 

  435. #: ../../../docs/configuring-playbook-jitsi.md:320

  436. msgid "To expose the port and have Docker forward the port, add the following configuration to your `vars.yml` files:"

  437. msgstr ""

  438. 

  439. #: ../../../docs/configuring-playbook-jitsi.md:326

  440. msgid "Reverse-proxy with Traefik"

  441. msgstr ""

  442. 

  443. #: ../../../docs/configuring-playbook-jitsi.md:328

  444. msgid "To make Traefik reverse-proxy to these additional JVBs, add the following configuration to your main `vars.yml` file (`inventory/host_vars/matrix.example.com/vars.yml`):"

  445. msgstr ""

  446. 

  447. #: ../../../docs/configuring-playbook-jitsi.md:364

  448. msgid "Run the playbook"

  449. msgstr ""

  450. 

  451. #: ../../../docs/configuring-playbook-jitsi.md:366

  452. msgid "After configuring `hosts` and `vars.yml` files, run the playbook with [playbook tags](playbook-tags.md) as below:"

  453. msgstr ""

  454. 

  455. #: ../../../docs/configuring-playbook-jitsi.md:372

  456. msgid "Troubleshooting"

  457. msgstr ""

  458. 

  459. #: ../../../docs/configuring-playbook-jitsi.md:374

  460. msgid "`Error: Account creation/modification not supported`"

  461. msgstr ""

  462. 

  463. #: ../../../docs/configuring-playbook-jitsi.md:376

  464. msgid "If you get an error like `Error: Account creation/modification not supported` with authentication enabled, it's likely that you had previously installed Jitsi without auth/guest support."

  465. msgstr ""

  466. 

  467. #: ../../../docs/configuring-playbook-jitsi.md:378

  468. msgid "In this case, you should consider to rebuild your Jitsi installation."

  469. msgstr ""

  470. 

  471. #: ../../../docs/configuring-playbook-jitsi.md:380

  472. msgid "Rebuilding your Jitsi installation"

  473. msgstr ""

  474. 

  475. #: ../../../docs/configuring-playbook-jitsi.md:382

  476. msgid "If you ever run into any trouble or if you have changed configuration (`jitsi_*` variables) too much, you can rebuild your Jitsi installation."

  477. msgstr ""

  478. 

  479. #: ../../../docs/configuring-playbook-jitsi.md:384

  480. msgid "We normally don't recommend manual intervention, but Jitsi services tend to generate a lot of configuration files, and it is often wise to start afresh setting the services up, rather than messing with the existing configuration files. Since not all of those files are managed by Ansible (at least not yet), you may sometimes need to delete them by yourself manually."

  481. msgstr ""

  482. 

  483. #: ../../../docs/configuring-playbook-jitsi.md:386

  484. msgid "To rebuild your Jitsi configuration, follow the procedure below:"

  485. msgstr ""

  486. 

  487. #: ../../../docs/configuring-playbook-jitsi.md:388

  488. msgid "run this command locally to stop all Jitsi services: `just run-tags stop-group --extra-vars=group=jitsi`"

  489. msgstr ""

  490. 

  491. #: ../../../docs/configuring-playbook-jitsi.md:389

  492. msgid "log in the server with SSH"

  493. msgstr ""

  494. 

  495. #: ../../../docs/configuring-playbook-jitsi.md:390

  496. msgid "run this command remotely to remove all Jitsi configuration & data: `rm -rf /matrix/jitsi`"

  497. msgstr ""

  498. 

  499. #: ../../../docs/configuring-playbook-jitsi.md:391

  500. msgid "run this command locally to set up Jitsi anew and restart services: `just install-service jitsi`"

  501. msgstr ""