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.

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