Matrix Docker Ansible eploy
Вы не можете выбрать более 25 тем Темы должны начинаться с буквы или цифры, могут содержать дефисы(-) и должны содержать не более 35 символов.

450 строки
14 KiB

  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. #: ../../../docs/installing.md:1
  24. msgid "Installing"
  25. msgstr ""
  26. #: ../../../docs/installing.md:3
  27. msgid ""
  28. "<sup>[Prerequisites](prerequisites.md) > [Configuring your DNS settings"
  29. "](configuring-dns.md) > [Getting the playbook](getting-the-playbook.md) >"
  30. " [Configuring the playbook](configuring-playbook.md) > Installing</sup>"
  31. msgstr ""
  32. #: ../../../docs/installing.md:5
  33. msgid ""
  34. "If you've configured your DNS records and the playbook, you can start the"
  35. " installation procedure."
  36. msgstr ""
  37. #: ../../../docs/installing.md:7
  38. msgid "Update Ansible roles"
  39. msgstr ""
  40. #: ../../../docs/installing.md:9
  41. msgid ""
  42. "Before installing, you need to update the Ansible roles that this "
  43. "playbook uses and fetches from outside."
  44. msgstr ""
  45. #: ../../../docs/installing.md:11
  46. msgid ""
  47. "To update your playbook directory and all upstream Ansible roles (defined"
  48. " in the `requirements.yml` file), run:"
  49. msgstr ""
  50. #: ../../../docs/installing.md:13
  51. msgid "either: `just update`"
  52. msgstr ""
  53. #: ../../../docs/installing.md:14
  54. msgid ""
  55. "or: a combination of `git pull` and `just roles` (or `make roles` if you "
  56. "have `make` program on your computer instead of `just`)"
  57. msgstr ""
  58. #: ../../../docs/installing.md:16
  59. msgid ""
  60. "If you don't have either `just` tool or `make` program, you can run the "
  61. "`ansible-galaxy` tool directly: `rm -rf roles/galaxy; ansible-galaxy "
  62. "install -r requirements.yml -p roles/galaxy/ --force`"
  63. msgstr ""
  64. #: ../../../docs/installing.md:18
  65. msgid ""
  66. "For details about `just` commands, take a look at: [Running `just` "
  67. "commands](just.md)."
  68. msgstr ""
  69. #: ../../../docs/installing.md:20
  70. msgid "Install Matrix server and services"
  71. msgstr ""
  72. #: ../../../docs/installing.md:22
  73. msgid ""
  74. "The Ansible playbook's tasks are tagged, so that certain parts of the "
  75. "Ansible playbook can be run without running all other tasks."
  76. msgstr ""
  77. #: ../../../docs/installing.md:24
  78. msgid ""
  79. "The general command syntax for installation (and also maintenance) is: "
  80. "`ansible-playbook -i inventory/hosts setup.yml "
  81. "--tags=COMMA_SEPARATED_TAGS_GO_HERE`. It is recommended to get yourself "
  82. "familiar with the [playbook tags](playbook-tags.md) before proceeding."
  83. msgstr ""
  84. #: ../../../docs/installing.md:26
  85. msgid ""
  86. "If you **don't** use SSH keys for authentication, but rather a regular "
  87. "password, you may need to add `--ask-pass` to the all Ansible commands."
  88. msgstr ""
  89. #: ../../../docs/installing.md:28
  90. msgid ""
  91. "If you **do** use SSH keys for authentication, **and** use a non-root "
  92. "user to *become* root (sudo), you may need to add `-K` (`--ask-become-"
  93. "pass`) to all Ansible commands."
  94. msgstr ""
  95. #: ../../../docs/installing.md:30
  96. msgid ""
  97. "There 2 ways to start the installation process - depending on whether "
  98. "you're [Installing a brand new server (without importing "
  99. "data)](#installing-a-brand-new-server-without-importing-data) or "
  100. "[Installing a server into which you'll import old data](#installing-a"
  101. "-server-into-which-youll-import-old-data)."
  102. msgstr ""
  103. #: ../../../docs/installing.md:32
  104. msgid ""
  105. "**Note**: if you are migrating from an old server to a new one, take a "
  106. "look at [this guide](maintenance-migrating.md) instead. This is an easier"
  107. " and more straightforward way than installing a server and importing old "
  108. "data into it."
  109. msgstr ""
  110. #: ../../../docs/installing.md:34
  111. msgid "Installing a brand new server (without importing data)"
  112. msgstr ""
  113. #: ../../../docs/installing.md:36
  114. msgid ""
  115. "If this is **a brand new** Matrix server and you **won't be importing old"
  116. " data into it**, run all these tags:"
  117. msgstr ""
  118. #: ../../../docs/installing.md:42
  119. msgid "This will do a full installation and start all Matrix services."
  120. msgstr ""
  121. #: ../../../docs/installing.md:44
  122. msgid ""
  123. "**Note**: if the command does not work as expected, make sure that you "
  124. "have properly installed and configured software required to run the "
  125. "playbook, as described on [Prerequisites](prerequisites.md)."
  126. msgstr ""
  127. #: ../../../docs/installing.md:46
  128. msgid "Installing a server into which you'll import old data"
  129. msgstr ""
  130. #: ../../../docs/installing.md:48
  131. msgid ""
  132. "If you will be importing data into your newly created Matrix server, "
  133. "install it, but **do not** start its services just yet. Starting its "
  134. "services or messing with its database now will affect your data import "
  135. "later on."
  136. msgstr ""
  137. #: ../../../docs/installing.md:50
  138. msgid ""
  139. "To do the installation **without** starting services, run `ansible-"
  140. "playbook` with the `install-all` tag only:"
  141. msgstr ""
  142. #: ../../../docs/installing.md:56
  143. msgid ""
  144. "⚠️ **Warning**: do not run the just \"recipe\" `just install-all` "
  145. "instead, because it automatically starts services at the end of "
  146. "execution. See: [Difference between playbook tags and shortcuts](just.md"
  147. "#difference-between-playbook-tags-and-shortcuts)"
  148. msgstr ""
  149. #: ../../../docs/installing.md:58
  150. msgid "When this command completes, services won't be running yet."
  151. msgstr ""
  152. #: ../../../docs/installing.md:60
  153. msgid "You can now:"
  154. msgstr ""
  155. #: ../../../docs/installing.md:62
  156. msgid ""
  157. "[Importing an existing SQLite database (from another Synapse installation"
  158. ")](importing-synapse-sqlite.md) (optional)"
  159. msgstr ""
  160. #: ../../../docs/installing.md:64
  161. msgid ""
  162. "[Importing an existing Postgres database (from another installation"
  163. ")](importing-postgres.md) (optional)"
  164. msgstr ""
  165. #: ../../../docs/installing.md:66
  166. msgid ""
  167. "[Importing `media_store` data files from an existing Synapse installation"
  168. "](importing-synapse-media-store.md) (optional)"
  169. msgstr ""
  170. #: ../../../docs/installing.md:68
  171. msgid ".. and then proceed to starting all services:"
  172. msgstr ""
  173. #: ../../../docs/installing.md:74
  174. msgid "Create your user account"
  175. msgstr ""
  176. #: ../../../docs/installing.md:76
  177. msgid ""
  178. "ℹ️ *You can skip this step if you have installed a server and imported "
  179. "old data to it.*"
  180. msgstr ""
  181. #: ../../../docs/installing.md:78
  182. msgid ""
  183. "As you have configured your brand new server and the client, you need to "
  184. "**create your user account** on your Matrix server."
  185. msgstr ""
  186. #: ../../../docs/installing.md:80
  187. msgid ""
  188. "After creating the user account, you can log in to it with [Element Web"
  189. "](configuring-playbook-client-element-web.md) that this playbook has "
  190. "installed for you at this URL: `https://element.example.com/`."
  191. msgstr ""
  192. #: ../../../docs/installing.md:82
  193. msgid ""
  194. "To create your user account (as an administrator of the server) via this "
  195. "Ansible playbook, run the command below on your local computer."
  196. msgstr ""
  197. #: ../../../docs/installing.md:84
  198. msgid "**Notes**:"
  199. msgstr ""
  200. #: ../../../docs/installing.md:85
  201. msgid "Make sure to adjust `YOUR_USERNAME_HERE` and `YOUR_PASSWORD_HERE`"
  202. msgstr ""
  203. #: ../../../docs/installing.md:86
  204. msgid ""
  205. "For `YOUR_USERNAME_HERE`, use a plain username like `alice`, not your "
  206. "full ID (`@alice:example.com`)"
  207. msgstr ""
  208. #: ../../../docs/installing.md:87
  209. msgid ""
  210. "Use `admin=yes` to make your user account an administrator of the Matrix "
  211. "server"
  212. msgstr ""
  213. #: ../../../docs/installing.md:95
  214. msgid ""
  215. "Feel free to create as many accounts (for friends, family, etc.) as you "
  216. "want. Still, perhaps you should grant full administrative access to your "
  217. "account only (with `admin=yes`), and others should be created with "
  218. "`admin=no`."
  219. msgstr ""
  220. #: ../../../docs/installing.md:97
  221. msgid ""
  222. "For more information, see the documentation for [registering users"
  223. "](registering-users.md)."
  224. msgstr ""
  225. #: ../../../docs/installing.md:99
  226. msgid "Finalize the installation"
  227. msgstr ""
  228. #: ../../../docs/installing.md:101
  229. msgid ""
  230. "Now you've configured Matrix services and your user account, you need to "
  231. "**finalize the installation process** by [setting up Matrix delegation "
  232. "(redirection)](howto-server-delegation.md), so that your Matrix server "
  233. "(`matrix.example.com`) can present itself as the base domain "
  234. "(`example.com`) in the Matrix network."
  235. msgstr ""
  236. #: ../../../docs/installing.md:103
  237. msgid ""
  238. "This is required for federation to work! Without a proper configuration, "
  239. "your server will effectively not be part of the Matrix network."
  240. msgstr ""
  241. #: ../../../docs/installing.md:105
  242. msgid ""
  243. "To configure the delegation, you have these two options. Choose one of "
  244. "them according to your situation."
  245. msgstr ""
  246. #: ../../../docs/installing.md:107
  247. msgid ""
  248. "If you can afford to point the base domain at the Matrix server, follow "
  249. "the instructions below which guide you into [serving the base domain"
  250. "](configuring-playbook-base-domain-serving.md) from the integrated web "
  251. "server. It will enable you to use a Matrix user ID like "
  252. "`@alice:example.com` while hosting services on a subdomain like "
  253. "`matrix.example.com`."
  254. msgstr ""
  255. #: ../../../docs/installing.md:108
  256. msgid ""
  257. "Alternatively, if you're using the base domain for other purposes and "
  258. "cannot point it to the Matrix server (and thus cannot \"serve the base "
  259. "domain\" from it), you most likely need to [manually install well-known "
  260. "files on the base domain's server](configuring-well-known.md#manually-"
  261. "installing-well-known-files-on-the-base-domains-server), but feel free to"
  262. " familiarize yourself with all [server delegation (redirection) options"
  263. "](howto-server-delegation.md)."
  264. msgstr ""
  265. #: ../../../docs/installing.md:110
  266. msgid ""
  267. "To have the base domain served from the integrated web server, add the "
  268. "following configuration to your "
  269. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  270. msgstr ""
  271. #: ../../../docs/installing.md:116
  272. msgid "After configuring the playbook, run the command below:"
  273. msgstr ""
  274. #: ../../../docs/installing.md:122
  275. msgid "Things to do next"
  276. msgstr ""
  277. #: ../../../docs/installing.md:124
  278. msgid "After finilizing the installation, you can:"
  279. msgstr ""
  280. #: ../../../docs/installing.md:126
  281. msgid "[check if services work](maintenance-checking-services.md)"
  282. msgstr ""
  283. #: ../../../docs/installing.md:127
  284. msgid ""
  285. "or [set up additional services](configuring-playbook.md#other-"
  286. "configuration-options) (bridges to other chat networks, bots, etc.)"
  287. msgstr ""
  288. #: ../../../docs/installing.md:128
  289. msgid ""
  290. "or learn how to [upgrade services when new versions are released"
  291. "](maintenance-upgrading-services.md)"
  292. msgstr ""
  293. #: ../../../docs/installing.md:129
  294. msgid "or learn how to [maintain your server](faq.md#maintenance)"
  295. msgstr ""
  296. #: ../../../docs/installing.md:130
  297. msgid "or join some Matrix rooms:"
  298. msgstr ""
  299. #: ../../../docs/installing.md:131
  300. msgid ""
  301. "via the *Explore rooms* feature in Element Web or some other clients, or "
  302. "by discovering them using this [matrix-static "
  303. "list](https://view.matrix.org). **Note**: joining large rooms may "
  304. "overload small servers."
  305. msgstr ""
  306. #: ../../../docs/installing.md:132
  307. msgid ""
  308. "or come say Hi in our support room - [#matrix-docker-ansible-"
  309. "deploy:devture.com](https://matrix.to/#/#matrix-docker-ansible-"
  310. "deploy:devture.com). You might learn something or get to help someone "
  311. "else new to Matrix hosting."
  312. msgstr ""
  313. #: ../../../docs/installing.md:133
  314. msgid ""
  315. "or help make this playbook better by contributing (code, documentation, "
  316. "or [coffee/beer](https://liberapay.com/s.pantaleev/donate))"
  317. msgstr ""
  318. #: ../../../docs/installing.md:135
  319. msgid "Maintaining your setup in the future"
  320. msgstr ""
  321. #: ../../../docs/installing.md:137
  322. msgid ""
  323. "While this playbook helps you to set up Matrix services and maintain "
  324. "them, it will **not** automatically run the maintenance task for you. You"
  325. " will need to update the playbook and re-run it **manually**."
  326. msgstr ""
  327. #: ../../../docs/installing.md:139
  328. msgid ""
  329. "The upstream projects, which this playbook makes use of, occasionally if "
  330. "not often suffer from security vulnerabilities."
  331. msgstr ""
  332. #: ../../../docs/installing.md:141
  333. msgid ""
  334. "Since it is unsafe to keep outdated services running on the server "
  335. "connected to the internet, please consider to update the playbook and re-"
  336. "run it periodically, in order to keep the services up-to-date."
  337. msgstr ""
  338. #: ../../../docs/installing.md:143
  339. msgid ""
  340. "For more information about upgrading or maintaining services with the "
  341. "playbook, take at look at this page: [Upgrading the Matrix services"
  342. "](maintenance-upgrading-services.md)"
  343. msgstr ""
  344. #: ../../../docs/installing.md:145
  345. msgid ""
  346. "Feel free to **re-run the setup command any time** you think something is"
  347. " wrong with the server configuration. Ansible will take your "
  348. "configuration and update your server to match."
  349. msgstr ""
  350. #: ../../../docs/installing.md:151
  351. msgid ""
  352. "**Note**: see [this page on the playbook tags](playbook-tags.md) for more"
  353. " information about those tags."
  354. msgstr ""
  355. #: ../../../docs/installing.md:153
  356. msgid "Make full use of `just` shortcut commands"
  357. msgstr ""
  358. #: ../../../docs/installing.md:155
  359. msgid ""
  360. "After you get familiar with reconfiguring and re-running the playbook to "
  361. "maintain the server, upgrade its services, etc., you probably would like "
  362. "to make use of `just` shortcut commands for faster input."
  363. msgstr ""
  364. #: ../../../docs/installing.md:157
  365. msgid ""
  366. "For example, `just install-all` is useful for maintaining your setup "
  367. "quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-"
  368. "in-playbook-runtime) than `just setup-all`) when its components remain "
  369. "unchanged. If you adjust your `vars.yml` to remove other components, "
  370. "you'd need to run `just setup-all`, or these components will still remain"
  371. " installed."
  372. msgstr ""
  373. #: ../../../docs/installing.md:159
  374. msgid ""
  375. "You can learn about the shortcut commands on this page: [Running `just` "
  376. "commands](just.md)"
  377. msgstr ""