mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-22 20:45:48 +00:00
d4f8d0918a
Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
260 lines
8.8 KiB
Plaintext
260 lines
8.8 KiB
Plaintext
# 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/prerequisites.md:1
|
|
msgid "Prerequisites"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:3
|
|
msgid ""
|
|
"<sup>Prerequisites > [Configuring your DNS settings](configuring-dns.md) "
|
|
"> [Getting the playbook](getting-the-playbook.md) > [Configuring the "
|
|
"playbook](configuring-playbook.md) > [Installing](installing.md)</sup>"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:5
|
|
msgid ""
|
|
"To install Matrix services using this Ansible playbook, you need to "
|
|
"prepare several requirements both on your local computer (where you will "
|
|
"run the playbook to configure the server) and the server (where the "
|
|
"playbook will install the Matrix services for you). **These requirements "
|
|
"need to be set up manually** before proceeding to the next step."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:7
|
|
msgid ""
|
|
"We will be using `example.com` as the domain in the following "
|
|
"instruction. Please remember to replace it with your own domain before "
|
|
"running any commands."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:9
|
|
msgid ""
|
|
"**Note**: if you do not have an existing Matrix server and want to start "
|
|
"quickly with \"opinionated defaults\", we suggest you to follow ⚡ "
|
|
"**[Quick start](quick-start.md)** installation guide."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:11
|
|
msgid "Your local computer"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:13
|
|
msgid ""
|
|
"[Ansible](http://ansible.com/) program. It's used to run this playbook "
|
|
"and configures your server for you. Take a look at [our guide about "
|
|
"Ansible](ansible.md) for more information, as well as [version "
|
|
"requirements](ansible.md#supported-ansible-versions) and alternative ways"
|
|
" to run Ansible."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:15
|
|
msgid ""
|
|
"[passlib](https://passlib.readthedocs.io/en/stable/index.html) Python "
|
|
"library. See [this official "
|
|
"documentation](https://passlib.readthedocs.io/en/stable/install.html"
|
|
"#installation-instructions) for an instruction to install it. On most "
|
|
"distros, you need to install some `python-passlib` or `py3-passlib` "
|
|
"package, etc."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:17
|
|
msgid ""
|
|
"[`git`](https://git-scm.com/) as the recommended way to download the "
|
|
"playbook. `git` may also be required on the server if you will be [self-"
|
|
"building](self-building.md) components."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:19
|
|
msgid ""
|
|
"[`just`](https://github.com/casey/just) for running `just roles`, `just "
|
|
"update`, etc. (see [`justfile`](../justfile)), although you can also run "
|
|
"these commands manually. Take at look at this documentation for more "
|
|
"information: [Running `just` commands](just.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:21
|
|
msgid ""
|
|
"Strong password (random strings) generator. The playbook often requires "
|
|
"you to create a strong password and use it for settings on `vars.yml`, "
|
|
"components, etc. As any tools should be fine, this playbook has adopted "
|
|
"[`pwgen`](https://linux.die.net/man/1/pwgen) (running `pwgen -s 64 1`). "
|
|
"[Password Tech](https://pwgen-win.sourceforge.io/), formerly known as "
|
|
"\"PWGen for Windows\", is available as free and open source password "
|
|
"generator for Windows. Generally, using a random generator available on "
|
|
"the internet is not recommended."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:23
|
|
msgid "Server"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:25
|
|
msgid ""
|
|
"(Recommended) An **x86** server ([What kind of server specs do I "
|
|
"need?](faq.md#what-kind-of-server-specs-do-i-need)) running one of these "
|
|
"operating systems that make use of [systemd](https://systemd.io/):"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:26
|
|
msgid "**Archlinux**"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:27
|
|
msgid ""
|
|
"**CentOS**, **Rocky Linux**, **AlmaLinux**, or possibly other RHEL "
|
|
"alternatives (although your mileage may vary)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:28
|
|
msgid "**Debian** (10/Buster or newer)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:29
|
|
msgid ""
|
|
"**Ubuntu** (18.04 or newer, although [20.04 may be "
|
|
"problematic](ansible.md#supported-ansible-versions) if you run the "
|
|
"Ansible playbook on it)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:31
|
|
msgid ""
|
|
"Generally, newer is better. We only strive to support released stable "
|
|
"versions of distributions, not betas or pre-releases. This playbook can "
|
|
"take over your whole server or co-exist with other services that you have"
|
|
" there."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:33
|
|
msgid ""
|
|
"This playbook somewhat supports running on non-`amd64` architectures like"
|
|
" ARM. See [Alternative Architectures](alternative-architectures.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:35
|
|
msgid ""
|
|
"If your distro runs within an [LXC "
|
|
"container](https://linuxcontainers.org/), you may hit [this "
|
|
"issue](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/issues/703). It can be worked around, if absolutely necessary, but"
|
|
" we suggest that you avoid running from within an LXC container."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:37
|
|
msgid ""
|
|
"`root` access to your server (or a user capable of elevating to `root` "
|
|
"via `sudo`)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:39
|
|
msgid ""
|
|
"[Python](https://www.python.org/). Most distributions install Python by "
|
|
"default, but some don't (e.g. Ubuntu 18.04) and require manual "
|
|
"installation (something like `apt-get install python3`). On some distros,"
|
|
" Ansible may incorrectly [detect the Python "
|
|
"version](https://docs.ansible.com/ansible/latest/reference_appendices/interpreter_discovery.html)"
|
|
" (2 vs 3) and you may need to explicitly specify the interpreter path in "
|
|
"`inventory/hosts` during installation (e.g. "
|
|
"`ansible_python_interpreter=/usr/bin/python3`)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:41
|
|
msgid ""
|
|
"[sudo](https://www.sudo.ws/), even when you've configured Ansible to log "
|
|
"in as `root`. Some distributions, like a minimal Debian net install, do "
|
|
"not include the `sudo` package by default."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:43
|
|
msgid ""
|
|
"An HTTPS-capable web server at the base domain name (`example.com`) which"
|
|
" is capable of serving static files. Unless you decide to [Serve the base"
|
|
" domain from the Matrix server](configuring-playbook-base-domain-"
|
|
"serving.md) or alternatively, to use DNS SRV records for [Server "
|
|
"Delegation](howto-server-delegation.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:45
|
|
msgid ""
|
|
"Properly configured DNS records for `example.com` (details in "
|
|
"[Configuring DNS](configuring-dns.md))."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:47
|
|
msgid ""
|
|
"Some TCP/UDP ports open. This playbook (actually [Docker "
|
|
"itself](https://docs.docker.com/network/iptables/)) configures the "
|
|
"server's internal firewall for you. In most cases, you don't need to do "
|
|
"anything special. But **if your server is running behind another "
|
|
"firewall**, you'd need to open these ports:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:49
|
|
msgid "`80/tcp`: HTTP webserver"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:50
|
|
msgid "`443/tcp` and `443/udp`: HTTPS webserver"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:51
|
|
msgid "`3478/tcp`: TURN over TCP (used by Coturn)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:52
|
|
msgid "`3478/udp`: TURN over UDP (used by Coturn)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:53
|
|
msgid "`5349/tcp`: TURN over TCP (used by Coturn)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:54
|
|
msgid "`5349/udp`: TURN over UDP (used by Coturn)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:55
|
|
msgid ""
|
|
"`8448/tcp` and `8448/udp`: Matrix Federation API HTTPS webserver. In some"
|
|
" cases, this **may necessary even with federation disabled**. Integration"
|
|
" Servers (like Dimension) and Identity Servers (like ma1sd) may need to "
|
|
"access `openid` APIs on the federation port."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:56
|
|
msgid "the range `49152-49172/udp`: TURN over UDP"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:57
|
|
msgid ""
|
|
"potentially some other ports, depending on the additional (non-default) "
|
|
"services that you enable in the **configuring the playbook** step (later "
|
|
"on). Consult each service's documentation page in `docs/` for that."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/prerequisites.md:61
|
|
msgid ""
|
|
"[▶️](configuring-dns.md) When ready to proceed, continue with "
|
|
"[Configuring DNS](configuring-dns.md)."
|
|
msgstr ""
|
|
|