|
- # SOME DESCRIPTIVE TITLE.
- # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
- # members
- # This file is distributed under the same license as the
- # matrix-docker-ansible-deploy package.
- # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
- #
- #, fuzzy
- msgid ""
- msgstr ""
- "Project-Id-Version: matrix-docker-ansible-deploy \n"
- "Report-Msgid-Bugs-To: \n"
- "POT-Creation-Date: 2024-12-16 12:05+0900\n"
- "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
- "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
- "Language: jp\n"
- "Language-Team: jp <LL@li.org>\n"
- "MIME-Version: 1.0\n"
- "Content-Type: text/plain; charset=utf-8\n"
- "Content-Transfer-Encoding: 8bit\n"
- "Generated-By: Babel 2.16.0\n"
-
- #: ../../../docs/configuring-playbook-jitsi.md:1
- msgid "Setting up the Jitsi video-conferencing platform (optional)"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:3
- msgid ""
- "The playbook can install the [Jitsi](https://jitsi.org/) video-"
- "conferencing platform and integrate it with Element clients ([Element Web"
- "](configuring-playbook-client-element-web.md)/Desktop, Android and iOS)."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:5
- msgid ""
- "Jitsi installation is **not enabled by default**, because it's not a core"
- " component of Matrix services."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:7
- msgid ""
- "The setup done by the playbook is very similar to [docker-jitsi-"
- "meet](https://github.com/jitsi/docker-jitsi-meet). You can refer to the "
- "documentation there for many of the options here."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:9
- msgid "Prerequisites"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:11
- msgid "You may need to open the following ports to your server:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:13
- msgid "`4443/tcp` - RTP media fallback over TCP"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:14
- msgid ""
- "`10000/udp` - RTP media over UDP. Depending on your firewall/NAT setup, "
- "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))."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:16
- msgid "Adjusting the playbook configuration"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:18
- msgid ""
- "To enable Jitsi, add the following configuration to your "
- "`inventory/host_vars/matrix.example.com/vars.yml` file:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:24
- msgid "Adjusting the Jitsi URL"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:26
- msgid ""
- "By default, this playbook installs Jitsi on the `jitsi.` subdomain "
- "(`jitsi.example.com`) and requires you to [adjust your DNS records"
- "](#adjusting-dns-records)."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:28
- msgid ""
- "By tweaking the `jitsi_hostname` variable, you can easily make the "
- "service available at a **different hostname** than the default one."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:30
- msgid ""
- "Example additional configuration for your "
- "`inventory/host_vars/matrix.example.com/vars.yml` file:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:37
- msgid "Adjusting DNS records"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:39
- msgid ""
- "Once you've decided on the domain and path, **you may need to adjust your"
- " DNS** records to point the Jitsi domain to the Matrix server."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:41
- msgid ""
- "By default, you will need to create a CNAME record for `jitsi`. See "
- "[Configuring DNS](configuring-dns.md) for details about DNS changes."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:43
- msgid "(Optional) Configure Jitsi authentication and guests mode"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:45
- msgid ""
- "By default the Jitsi Meet instance does not require any kind of login and"
- " is open to use for anyone without registration."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:47
- msgid ""
- "If you're fine with such an open Jitsi instance, please skip to "
- "[Installing](#installing)."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:49
- msgid ""
- "If you would like to control who is allowed to open meetings on your new "
- "Jitsi instance, then please follow the following steps to enable Jitsi's "
- "authentication and optionally guests mode."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:51
- msgid ""
- "Currently, there are three supported authentication modes: 'internal' "
- "(default), 'matrix' and 'ldap'."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:53
- msgid ""
- "**Note**: Authentication is not tested via the playbook's self-checks. We"
- " therefore recommend that you manually verify if authentication is "
- "required by jitsi. For this, try to manually create a conference on "
- "jitsi.example.com in your browser."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:55
- msgid "Authenticate using Jitsi accounts (Auth-Type 'internal')"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:57
- msgid ""
- "The default authentication mechanism is 'internal' auth, which requires "
- "jitsi-accounts to be setup and is the recommended setup, as it also works"
- " in federated rooms. With authentication enabled, all meeting rooms have "
- "to be opened by a registered user, after which guests are free to join. "
- "If a registered host is not yet present, guests are put on hold in "
- "individual waiting rooms."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:59
- msgid ""
- "Add these lines to your `inventory/host_vars/matrix.example.com/vars.yml`"
- " configuration:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:71
- msgid ""
- "**Caution**: Accounts added here and subsequently removed will not be "
- "automatically removed from the Prosody server until user account cleaning"
- " is integrated into the playbook."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:73
- msgid ""
- "**If you get an error** like this: \"Error: Account creation/modification"
- " not supported.\", it's likely that you had previously installed Jitsi "
- "without auth/guest support. In such a case, you should look into "
- "[Rebuilding your Jitsi installation](#rebuilding-your-jitsi-"
- "installation)."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:75
- msgid "Authenticate using Matrix OpenID (Auth-Type 'matrix')"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:77
- msgid ""
- "**Attention: Probably breaks Jitsi in federated rooms and does not allow "
- "sharing conference links with guests.**"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:79
- msgid ""
- "Using this authentication type require a [Matrix User Verification "
- "Service](https://github.com/matrix-org/matrix-user-verification-service)."
- " By default, this playbook creates and configures a user-verification-"
- "service to run locally, see [configuring-user-verification-service"
- "](configuring-playbook-user-verification-service.md)."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:81
- msgid "To enable set this configuration at host level:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:89
- 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)."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:91
- msgid "Authenticate using LDAP (Auth-Type 'ldap')"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:93
- msgid "An example LDAP configuration could be:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:113
- 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."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:115
- msgid "(Optional) Making your Jitsi server work on a LAN"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:117
- msgid ""
- "By default the Jitsi Meet instance does not work with a client in LAN "
- "(Local Area Network), even if others are connected from WAN. There are no"
- " video and audio. In the case of WAN to WAN everything is ok."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:119
- msgid ""
- "The reason is the Jitsi VideoBridge git to LAN client the IP address of "
- "the docker image instead of the host. The "
- "[documentation](https://jitsi.github.io/handbook/docs/devops-guide"
- "/devops-guide-docker/#running-behind-nat-or-on-a-lan-environment) of "
- "Jitsi in docker suggest to add `JVB_ADVERTISE_IPS` in enviornment "
- "variable to make it work."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:121
- msgid "Here is how to do it in the playbook."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:123
- msgid ""
- "Add these two lines to your "
- "`inventory/host_vars/matrix.example.com/vars.yml` configuration:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:130
- msgid "(Optional) Fine tune Jitsi"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:132
- msgid ""
- "Sample **additional** `inventory/host_vars/matrix.example.com/vars.yml` "
- "configuration to save up resources (explained below):"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:147
- msgid ""
- "You may want to **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/)"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:149
- msgid ""
- "You may wish to **disable audio levels** to avoid excessive refresh of "
- "the client-side page and decrease the CPU consumption involved."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:151
- msgid ""
- "You may want to **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 found by default in other webconference "
- "applications such as Office 365 Teams (limit is set to 4). Read how it "
- "works [here](https://github.com/jitsi/jitsi-"
- "videobridge/blob/master/doc/last-n.md) and performance evaluation on this"
- " [study](https://jitsi.org/wp-"
- "content/uploads/2016/12/nossdav2015lastn.pdf)."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:153
- msgid ""
- "You may want to **limit the maximum video resolution**, to save up "
- "resources on both server and clients."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:155
- msgid "(Optional) Specify a Max number of participants on a Jitsi conference"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:157
- msgid ""
- "The playbook allows a user to set a max number of participants allowed to"
- " join a Jitsi conference. By default there is no limit."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:159
- msgid ""
- "In order to set the max number of participants use the following "
- "**additional** configuration:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:165
- msgid "(Optional) Additional JVBs"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:167
- 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 may need "
- "to provision additional JVB services on other hosts."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:169
- msgid ""
- "There is an ansible playbook that can be run with the following tag: "
- "`ansible-playbook -i inventory/hosts --limit jitsi_jvb_servers "
- "jitsi_jvb.yml --tags=common,setup-additional-jitsi-jvb,start`"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:171
- msgid ""
- "For this role to work you will need an additional section in the ansible "
- "hosts file with the details of the JVB hosts, for example:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:178
- msgid ""
- "Each JVB will require a server ID to be set so that it can be uniquely "
- "identified and this allows Jitsi to keep track of which conferences are "
- "on which JVB. The server ID is set with the variable "
- "`jitsi_jvb_server_id` which ends up as the JVB_WS_SERVER_ID environment "
- "variables in the JVB docker container. This variable can be set via the "
- "host file, a parameter to the ansible command or in the `vars.yaml` for "
- "the host which will have the additional JVB. For example:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:190
- msgid ""
- "Note that the server ID `jvb-1` is reserved for the JVB instance running "
- "on the Matrix host and therefore should not be used as the ID of an "
- "additional jvb host."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:192
- msgid ""
- "The additional JVB will also need to expose the colibri web socket port "
- "and this can be done with the following variable:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:198
- msgid ""
- "The JVB will also need to know where the prosody xmpp server is located, "
- "similar to the server ID this can be set in the vars for the JVB by using"
- " the variable `jitsi_xmpp_server`. The Jitsi prosody container is "
- "deployed on the Matrix server by default so the value can be set to the "
- "Matrix domain. For example:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:204
- msgid ""
- "However, it can also be set the ip address of the Matrix server. This can"
- " be useful if you wish to use a private ip. For example:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:210
- msgid ""
- "For the JVB to be able to contact the XMPP server, the latter must expose"
- " the XMPP port (5222). By default, the Matrix server does not expose the "
- "port; only the XMPP container exposes it internally inside the host, "
- "which means that the first JVB (which runs on the Matrix server) can "
- "reach it but the additional JVB cannot. The port is exposed by setting "
- "`jitsi_prosody_container_jvb_host_bind_port` like this:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:216
- msgid "(The default is empty; if it's set then docker forwards the port.)"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:218
- msgid ""
- "Applied together this will allow you to provision extra JVB instances "
- "which will register themselves with the prosody service and be available "
- "for jicofo to route conferences too."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:220
- msgid ""
- "To make Traefik reverse-proxy to these additional JVBs (living on other "
- "hosts), **you would need to add the following Traefik configuration "
- "extension**:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:256
- msgid "(Optional) Enable Gravatar"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:258
- msgid ""
- "In the default Jisti Meet configuration, gravatar.com is enabled as an "
- "avatar service. This results in third party request leaking data to "
- "gravatar. Since Element clients already send the url of configured Matrix"
- " avatars to Jitsi, we disabled gravatar."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:260
- msgid "To enable Gravatar set:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:266
- msgid ""
- "**Beware**: This leaks information to a third party, namely the Gravatar-"
- "Service (unless configured otherwise: gravatar.com). Besides metadata, "
- "this includes the Matrix user_id and possibly the room identifier (via "
- "`referrer` header)."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:268
- msgid "Installing"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:270
- 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:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:277
- msgid ""
- "The shortcut commands with the [`just` program](just.md) are also "
- "available: `just install-all` or `just setup-all`"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:279
- 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."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:281
- msgid "Usage"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:283
- msgid "You can use the self-hosted Jitsi server in multiple ways:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:285
- 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."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:287
- msgid ""
- "**by adding a widget to a room via the Dimension integration manager**. "
- "You'll have to point the widget to your own Jitsi server manually. See "
- "our [Dimension integration manager](./configuring-playbook-dimension.md) "
- "documentation page for more details. Naturally, Dimension would need to "
- "be installed first (the playbook doesn't install it by default)."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:289
- msgid ""
- "**directly (without any Matrix integration)**. Just go to "
- "`https://jitsi.example.com`"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:291
- msgid ""
- "**Note**: Element apps on mobile devices currently [don't support joining"
- " meetings on a self-hosted Jitsi server](https://github.com/element-hq"
- "/riot-web/blob/601816862f7d84ac47547891bd53effa73d32957/docs/jitsi.md"
- "#mobile-app-support)."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:293
- msgid "Troubleshooting"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:295
- msgid "Rebuilding your Jitsi installation"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:297
- msgid ""
- "**If you ever run into any trouble** or **if you change configuration "
- "(`jitsi_*` variables) too much**, we urge you to rebuild your Jitsi "
- "setup."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:299
- msgid ""
- "We normally don't require such manual intervention for other services, "
- "but Jitsi services generate a lot of configuration files on their own."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:301
- msgid ""
- "These files are not all managed by Ansible (at least not yet), so you may"
- " sometimes need to delete them all and start fresh."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:303
- msgid "To rebuild your Jitsi configuration:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:305
- msgid ""
- "ask Ansible to stop all Jitsi services: `just run-tags stop-group "
- "--extra-vars=group=jitsi`"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:306
- msgid ""
- "SSH into the server and do this and remove all Jitsi configuration & data"
- " (`rm -rf /matrix/jitsi`)"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-jitsi.md:307
- msgid ""
- "ask Ansible to set up Jitsi anew and restart services (`just install-"
- "service jitsi`)"
- msgstr ""
|