# 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 , 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 \n" "Language: jp\n" "Language-Team: jp \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 "" "Prerequisites > [Configuring your DNS settings](configuring-dns.md) " "> [Getting the playbook](getting-the-playbook.md) > [Configuring the " "playbook](configuring-playbook.md) > [Installing](installing.md)" 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 ""