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.
8820 Commits
5 Branches
1.6 GiB
 
 
 
Tree: c51e771d1a
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'c51e771d1a'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/bg/LC_MESSAGES/docs/prerequisites.po

261 lines
8.9 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: bg\n"

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

  18. "Plural-Forms: nplurals=2; plural=(n != 1);\n"

  19. "MIME-Version: 1.0\n"

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

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

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

  23. 

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

  25. msgid "Prerequisites"

  26. msgstr ""

  27. 

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

  29. msgid ""

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

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

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

  33. msgstr ""

  34. 

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

  36. msgid ""

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

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

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

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

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

  42. msgstr ""

  43. 

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

  45. msgid ""

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

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

  48. "running any commands."

  49. msgstr ""

  50. 

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

  52. msgid ""

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

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

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

  56. msgstr ""

  57. 

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

  59. msgid "Your local computer"

  60. msgstr ""

  61. 

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

  63. msgid ""

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

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

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

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

  68. " to run Ansible."

  69. msgstr ""

  70. 

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

  72. msgid ""

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

  74. "library. See [this official "

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

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

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

  78. "package, etc."

  79. msgstr ""

  80. 

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

  82. msgid ""

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

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

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

  86. msgstr ""

  87. 

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

  89. msgid ""

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

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

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

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

  94. msgstr ""

  95. 

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

  97. msgid ""

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

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

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

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

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

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

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

  105. "the internet is not recommended."

  106. msgstr ""

  107. 

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

  109. msgid "Server"

  110. msgstr ""

  111. 

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

  113. msgid ""

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

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

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

  117. msgstr ""

  118. 

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

  120. msgid "**Archlinux**"

  121. msgstr ""

  122. 

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

  124. msgid ""

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

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

  127. msgstr ""

  128. 

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

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

  131. msgstr ""

  132. 

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

  134. msgid ""

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

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

  137. "Ansible playbook on it)"

  138. msgstr ""

  139. 

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

  141. msgid ""

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

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

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

  145. " there."

  146. msgstr ""

  147. 

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

  149. msgid ""

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

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

  152. msgstr ""

  153. 

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

  155. msgid ""

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

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

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

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

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

  161. msgstr ""

  162. 

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

  164. msgid ""

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

  166. "via `sudo`)."

  167. msgstr ""

  168. 

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

  170. msgid ""

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

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

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

  174. " Ansible may incorrectly [detect the Python "

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

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

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

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

  179. msgstr ""

  180. 

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

  182. msgid ""

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

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

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

  186. msgstr ""

  187. 

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

  189. msgid ""

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

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

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

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

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

  195. msgstr ""

  196. 

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

  198. msgid ""

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

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

  201. msgstr ""

  202. 

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

  204. msgid ""

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

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

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

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

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

  210. msgstr ""

  211. 

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

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

  214. msgstr ""

  215. 

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

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

  218. msgstr ""

  219. 

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

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

  222. msgstr ""

  223. 

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

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

  226. msgstr ""

  227. 

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

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

  230. msgstr ""

  231. 

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

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

  234. msgstr ""

  235. 

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

  237. msgid ""

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

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

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

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

  242. msgstr ""

  243. 

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

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

  246. msgstr ""

  247. 

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

  249. msgid ""

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

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

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

  253. msgstr ""

  254. 

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

  256. msgid ""

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

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

  259. msgstr ""