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.
8818 Commits
16 Branches
66 MiB
 
 
Tree: 1636c49134
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '1636c49134'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/jp/LC_MESSAGES/docs/prerequisites.po

260 lines
8.8 KiB
Raw Blame History 

  1. # SOME DESCRIPTIVE TITLE.

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

  3. # members

  4. # This file is distributed under the same license as the

  5. # matrix-docker-ansible-deploy package.

  6. # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.

  7. #

  8. #, fuzzy

  9. msgid ""

  10. msgstr ""

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

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

  13. "POT-Creation-Date: 2024-12-16 12:05+0900\n"

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

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

  16. "Language: jp\n"

  17. "Language-Team: jp <LL@li.org>\n"

  18. "MIME-Version: 1.0\n"

  19. "Content-Type: text/plain; charset=utf-8\n"

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

  21. "Generated-By: Babel 2.16.0\n"

  22. 

  23. #: ../../../docs/prerequisites.md:1

  24. msgid "Prerequisites"

  25. msgstr ""

  26. 

  27. #: ../../../docs/prerequisites.md:3

  28. msgid ""

  29. "<sup>Prerequisites > [Configuring your DNS settings](configuring-dns.md) "

  30. "> [Getting the playbook](getting-the-playbook.md) > [Configuring the "

  31. "playbook](configuring-playbook.md) > [Installing](installing.md)</sup>"

  32. msgstr ""

  33. 

  34. #: ../../../docs/prerequisites.md:5

  35. msgid ""

  36. "To install Matrix services using this Ansible playbook, you need to "

  37. "prepare several requirements both on your local computer (where you will "

  38. "run the playbook to configure the server) and the server (where the "

  39. "playbook will install the Matrix services for you). **These requirements "

  40. "need to be set up manually** before proceeding to the next step."

  41. msgstr ""

  42. 

  43. #: ../../../docs/prerequisites.md:7

  44. msgid ""

  45. "We will be using `example.com` as the domain in the following "

  46. "instruction. Please remember to replace it with your own domain before "

  47. "running any commands."

  48. msgstr ""

  49. 

  50. #: ../../../docs/prerequisites.md:9

  51. msgid ""

  52. "**Note**: if you do not have an existing Matrix server and want to start "

  53. "quickly with \"opinionated defaults\", we suggest you to follow ⚡ "

  54. "**[Quick start](quick-start.md)** installation guide."

  55. msgstr ""

  56. 

  57. #: ../../../docs/prerequisites.md:11

  58. msgid "Your local computer"

  59. msgstr ""

  60. 

  61. #: ../../../docs/prerequisites.md:13

  62. msgid ""

  63. "[Ansible](http://ansible.com/) program. It's used to run this playbook "

  64. "and configures your server for you. Take a look at [our guide about "

  65. "Ansible](ansible.md) for more information, as well as [version "

  66. "requirements](ansible.md#supported-ansible-versions) and alternative ways"

  67. " to run Ansible."

  68. msgstr ""

  69. 

  70. #: ../../../docs/prerequisites.md:15

  71. msgid ""

  72. "[passlib](https://passlib.readthedocs.io/en/stable/index.html) Python "

  73. "library. See [this official "

  74. "documentation](https://passlib.readthedocs.io/en/stable/install.html"

  75. "#installation-instructions) for an instruction to install it. On most "

  76. "distros, you need to install some `python-passlib` or `py3-passlib` "

  77. "package, etc."

  78. msgstr ""

  79. 

  80. #: ../../../docs/prerequisites.md:17

  81. msgid ""

  82. "[`git`](https://git-scm.com/) as the recommended way to download the "

  83. "playbook. `git` may also be required on the server if you will be [self-"

  84. "building](self-building.md) components."

  85. msgstr ""

  86. 

  87. #: ../../../docs/prerequisites.md:19

  88. msgid ""

  89. "[`just`](https://github.com/casey/just) for running `just roles`, `just "

  90. "update`, etc. (see [`justfile`](../justfile)), although you can also run "

  91. "these commands manually. Take at look at this documentation for more "

  92. "information: [Running `just` commands](just.md)."

  93. msgstr ""

  94. 

  95. #: ../../../docs/prerequisites.md:21

  96. msgid ""

  97. "Strong password (random strings) generator. The playbook often requires "

  98. "you to create a strong password and use it for settings on `vars.yml`, "

  99. "components, etc. As any tools should be fine, this playbook has adopted "

  100. "[`pwgen`](https://linux.die.net/man/1/pwgen) (running `pwgen -s 64 1`). "

  101. "[Password Tech](https://pwgen-win.sourceforge.io/), formerly known as "

  102. "\"PWGen for Windows\", is available as free and open source password "

  103. "generator for Windows. Generally, using a random generator available on "

  104. "the internet is not recommended."

  105. msgstr ""

  106. 

  107. #: ../../../docs/prerequisites.md:23

  108. msgid "Server"

  109. msgstr ""

  110. 

  111. #: ../../../docs/prerequisites.md:25

  112. msgid ""

  113. "(Recommended) An **x86** server ([What kind of server specs do I "

  114. "need?](faq.md#what-kind-of-server-specs-do-i-need)) running one of these "

  115. "operating systems that make use of [systemd](https://systemd.io/):"

  116. msgstr ""

  117. 

  118. #: ../../../docs/prerequisites.md:26

  119. msgid "**Archlinux**"

  120. msgstr ""

  121. 

  122. #: ../../../docs/prerequisites.md:27

  123. msgid ""

  124. "**CentOS**, **Rocky Linux**, **AlmaLinux**, or possibly other RHEL "

  125. "alternatives (although your mileage may vary)"

  126. msgstr ""

  127. 

  128. #: ../../../docs/prerequisites.md:28

  129. msgid "**Debian** (10/Buster or newer)"

  130. msgstr ""

  131. 

  132. #: ../../../docs/prerequisites.md:29

  133. msgid ""

  134. "**Ubuntu** (18.04 or newer, although [20.04 may be "

  135. "problematic](ansible.md#supported-ansible-versions) if you run the "

  136. "Ansible playbook on it)"

  137. msgstr ""

  138. 

  139. #: ../../../docs/prerequisites.md:31

  140. msgid ""

  141. "Generally, newer is better. We only strive to support released stable "

  142. "versions of distributions, not betas or pre-releases. This playbook can "

  143. "take over your whole server or co-exist with other services that you have"

  144. " there."

  145. msgstr ""

  146. 

  147. #: ../../../docs/prerequisites.md:33

  148. msgid ""

  149. "This playbook somewhat supports running on non-`amd64` architectures like"

  150. " ARM. See [Alternative Architectures](alternative-architectures.md)."

  151. msgstr ""

  152. 

  153. #: ../../../docs/prerequisites.md:35

  154. msgid ""

  155. "If your distro runs within an [LXC "

  156. "container](https://linuxcontainers.org/), you may hit [this "

  157. "issue](https://github.com/spantaleev/matrix-docker-ansible-"

  158. "deploy/issues/703). It can be worked around, if absolutely necessary, but"

  159. " we suggest that you avoid running from within an LXC container."

  160. msgstr ""

  161. 

  162. #: ../../../docs/prerequisites.md:37

  163. msgid ""

  164. "`root` access to your server (or a user capable of elevating to `root` "

  165. "via `sudo`)."

  166. msgstr ""

  167. 

  168. #: ../../../docs/prerequisites.md:39

  169. msgid ""

  170. "[Python](https://www.python.org/). Most distributions install Python by "

  171. "default, but some don't (e.g. Ubuntu 18.04) and require manual "

  172. "installation (something like `apt-get install python3`). On some distros,"

  173. " Ansible may incorrectly [detect the Python "

  174. "version](https://docs.ansible.com/ansible/latest/reference_appendices/interpreter_discovery.html)"

  175. " (2 vs 3) and you may need to explicitly specify the interpreter path in "

  176. "`inventory/hosts` during installation (e.g. "

  177. "`ansible_python_interpreter=/usr/bin/python3`)"

  178. msgstr ""

  179. 

  180. #: ../../../docs/prerequisites.md:41

  181. msgid ""

  182. "[sudo](https://www.sudo.ws/), even when you've configured Ansible to log "

  183. "in as `root`. Some distributions, like a minimal Debian net install, do "

  184. "not include the `sudo` package by default."

  185. msgstr ""

  186. 

  187. #: ../../../docs/prerequisites.md:43

  188. msgid ""

  189. "An HTTPS-capable web server at the base domain name (`example.com`) which"

  190. " is capable of serving static files. Unless you decide to [Serve the base"

  191. " domain from the Matrix server](configuring-playbook-base-domain-"

  192. "serving.md) or alternatively, to use DNS SRV records for [Server "

  193. "Delegation](howto-server-delegation.md)."

  194. msgstr ""

  195. 

  196. #: ../../../docs/prerequisites.md:45

  197. msgid ""

  198. "Properly configured DNS records for `example.com` (details in "

  199. "[Configuring DNS](configuring-dns.md))."

  200. msgstr ""

  201. 

  202. #: ../../../docs/prerequisites.md:47

  203. msgid ""

  204. "Some TCP/UDP ports open. This playbook (actually [Docker "

  205. "itself](https://docs.docker.com/network/iptables/)) configures the "

  206. "server's internal firewall for you. In most cases, you don't need to do "

  207. "anything special. But **if your server is running behind another "

  208. "firewall**, you'd need to open these ports:"

  209. msgstr ""

  210. 

  211. #: ../../../docs/prerequisites.md:49

  212. msgid "`80/tcp`: HTTP webserver"

  213. msgstr ""

  214. 

  215. #: ../../../docs/prerequisites.md:50

  216. msgid "`443/tcp` and `443/udp`: HTTPS webserver"

  217. msgstr ""

  218. 

  219. #: ../../../docs/prerequisites.md:51

  220. msgid "`3478/tcp`: TURN over TCP (used by Coturn)"

  221. msgstr ""

  222. 

  223. #: ../../../docs/prerequisites.md:52

  224. msgid "`3478/udp`: TURN over UDP (used by Coturn)"

  225. msgstr ""

  226. 

  227. #: ../../../docs/prerequisites.md:53

  228. msgid "`5349/tcp`: TURN over TCP (used by Coturn)"

  229. msgstr ""

  230. 

  231. #: ../../../docs/prerequisites.md:54

  232. msgid "`5349/udp`: TURN over UDP (used by Coturn)"

  233. msgstr ""

  234. 

  235. #: ../../../docs/prerequisites.md:55

  236. msgid ""

  237. "`8448/tcp` and `8448/udp`: Matrix Federation API HTTPS webserver. In some"

  238. " cases, this **may necessary even with federation disabled**. Integration"

  239. " Servers (like Dimension) and Identity Servers (like ma1sd) may need to "

  240. "access `openid` APIs on the federation port."

  241. msgstr ""

  242. 

  243. #: ../../../docs/prerequisites.md:56

  244. msgid "the range `49152-49172/udp`: TURN over UDP"

  245. msgstr ""

  246. 

  247. #: ../../../docs/prerequisites.md:57

  248. msgid ""

  249. "potentially some other ports, depending on the additional (non-default) "

  250. "services that you enable in the **configuring the playbook** step (later "

  251. "on). Consult each service's documentation page in `docs/` for that."

  252. msgstr ""

  253. 

  254. #: ../../../docs/prerequisites.md:61

  255. msgid ""

  256. "[▶️](configuring-dns.md) When ready to proceed, continue with "

  257. "[Configuring DNS](configuring-dns.md)."

  258. msgstr ""