Matrix Docker Ansible eploy
25'ten fazla konu seçemezsiniz Konular bir harf veya rakamla başlamalı, kısa çizgiler ('-') içerebilir ve en fazla 35 karakter uzunluğunda olabilir.
 
 

615 satır
18 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/quick-start.md:1
  23. msgid "Quick start"
  24. msgstr ""
  25. #: ../../../docs/quick-start.md:9
  26. msgid ""
  27. "This page explains how to use this Ansible playbook to install Matrix "
  28. "services on your server with a minimal set of core services."
  29. msgstr ""
  30. #: ../../../docs/quick-start.md:11
  31. msgid ""
  32. "We will be using `example.com` as the \"base domain\" in the following "
  33. "instruction."
  34. msgstr ""
  35. #: ../../../docs/quick-start.md:13
  36. msgid "By following the instruction on this page, you will set up:"
  37. msgstr ""
  38. #: ../../../docs/quick-start.md:15
  39. msgid ""
  40. "**your own Matrix server** on a `matrix.example.com` server, which is "
  41. "configured to present itself as `example.com`"
  42. msgstr ""
  43. #: ../../../docs/quick-start.md:16
  44. msgid "**your user account** like `@alice:example.com` on the server"
  45. msgstr ""
  46. #: ../../../docs/quick-start.md:17
  47. msgid ""
  48. "a **self-hosted Matrix client**, [Element Web](configuring-playbook-"
  49. "client-element-web.md) with the default subdomain at "
  50. "`element.example.com`"
  51. msgstr ""
  52. #: ../../../docs/quick-start.md:18
  53. msgid ""
  54. "Matrix delegation, so that your `matrix.example.com` server (presenting "
  55. "itself as `example.com`) can join the Matrix Federation and communicate "
  56. "with any other server in the Matrix network"
  57. msgstr ""
  58. #: ../../../docs/quick-start.md:20
  59. msgid ""
  60. "Please remember to replace `example.com` with your own domain before "
  61. "running any commands."
  62. msgstr ""
  63. #: ../../../docs/quick-start.md:22
  64. msgid "Prerequisites"
  65. msgstr ""
  66. #: ../../../docs/quick-start.md:24
  67. msgid ""
  68. "<sup>This section is optimized for this quick-start guide and is derived "
  69. "from the following full-documentation page: "
  70. "[Prerequisites](prerequisites.md)</sup>"
  71. msgstr ""
  72. #: ../../../docs/quick-start.md:26
  73. msgid ""
  74. "At first, **check prerequisites** and prepare for installation by setting"
  75. " up programs [on your own computer](prerequisites.md#your-local-computer)"
  76. " and [your server](prerequisites.md#server). You also need `root` access "
  77. "on your server (a user that could elevate to `root` via `sudo` also "
  78. "works)."
  79. msgstr ""
  80. #: ../../../docs/quick-start.md:28
  81. msgid ""
  82. "When preparing your server, make sure to check [the server specs you "
  83. "need](faq.md#what-kind-of-server-specs-do-i-need). We recommend starting "
  84. "with a server having at least 2GB of memory."
  85. msgstr ""
  86. #: ../../../docs/quick-start.md:34
  87. msgid ""
  88. "If you encounter an error during installation, please make sure that you "
  89. "have installed and configured programs correctly."
  90. msgstr ""
  91. #: ../../../docs/quick-start.md:36
  92. msgid ""
  93. "One of the main reasons of basic errors is using an incompatible version "
  94. "of required software such as Ansible. Take a look at [our guide about "
  95. "Ansible](ansible.md) for more information. In short: installing the "
  96. "latest available version is recommended."
  97. msgstr ""
  98. #: ../../../docs/quick-start.md:38
  99. msgid "Configure your DNS settings"
  100. msgstr ""
  101. #: ../../../docs/quick-start.md:40
  102. msgid ""
  103. "<sup>This section is optimized for this quick-start guide and is derived "
  104. "from the following full-documentation page: [Configuring your DNS "
  105. "settings](configuring-dns.md)</sup>"
  106. msgstr ""
  107. #: ../../../docs/quick-start.md:42
  108. msgid ""
  109. "After installing and configuring prerequisites, you will need to "
  110. "**configure DNS records**."
  111. msgstr ""
  112. #: ../../../docs/quick-start.md:44
  113. msgid ""
  114. "To configure Matrix services in the default settings, go to your DNS "
  115. "service provider, and adjust DNS records as below."
  116. msgstr ""
  117. #: ../../../docs/quick-start.md
  118. msgid "Type"
  119. msgstr ""
  120. #: ../../../docs/quick-start.md
  121. msgid "Host"
  122. msgstr ""
  123. #: ../../../docs/quick-start.md
  124. msgid "Priority"
  125. msgstr ""
  126. #: ../../../docs/quick-start.md
  127. msgid "Weight"
  128. msgstr ""
  129. #: ../../../docs/quick-start.md
  130. msgid "Port"
  131. msgstr ""
  132. #: ../../../docs/quick-start.md
  133. msgid "Target"
  134. msgstr ""
  135. #: ../../../docs/quick-start.md
  136. msgid "A"
  137. msgstr ""
  138. #: ../../../docs/quick-start.md
  139. msgid "`matrix`"
  140. msgstr ""
  141. #: ../../../docs/quick-start.md
  142. msgid "-"
  143. msgstr ""
  144. #: ../../../docs/quick-start.md
  145. msgid "`matrix-server-IP`"
  146. msgstr ""
  147. #: ../../../docs/quick-start.md
  148. msgid "CNAME"
  149. msgstr ""
  150. #: ../../../docs/quick-start.md
  151. msgid "`element`"
  152. msgstr ""
  153. #: ../../../docs/quick-start.md
  154. msgid "`matrix.example.com`"
  155. msgstr ""
  156. #: ../../../docs/quick-start.md:51
  157. msgid ""
  158. "As the table illustrates, you need to create 2 subdomains "
  159. "(`matrix.example.com` and `element.example.com`) and point both of them "
  160. "to your server's IP address (DNS `A` record or `CNAME` record is fine)."
  161. msgstr ""
  162. #: ../../../docs/quick-start.md:53
  163. msgid "It might take some time for the DNS records to propagate after creation."
  164. msgstr ""
  165. #: ../../../docs/quick-start.md:55
  166. msgid ""
  167. "**💡 Note**: if you are using Cloudflare DNS, make sure to disable the "
  168. "proxy and set all records to \"DNS only\""
  169. msgstr ""
  170. #: ../../../docs/quick-start.md:57
  171. msgid "Get the playbook"
  172. msgstr ""
  173. #: ../../../docs/quick-start.md:59
  174. msgid ""
  175. "<sup>This section is optimized for this quick-start guide and is derived "
  176. "from the following full-documentation page: [Getting the playbook"
  177. "](getting-the-playbook.md)</sup>"
  178. msgstr ""
  179. #: ../../../docs/quick-start.md:61
  180. msgid "Next, let's **get the playbook's source code**."
  181. msgstr ""
  182. #: ../../../docs/quick-start.md:63
  183. msgid ""
  184. "We recommend to do so with [git](https://git-scm.com/) as it enables you "
  185. "to keep it up to date with the latest source code. While it is possible "
  186. "to download the playbook as a ZIP archive, it is not recommended."
  187. msgstr ""
  188. #: ../../../docs/quick-start.md:65
  189. msgid ""
  190. "To get the playbook with git, install git on your computer, go to a "
  191. "directory, and run the command:"
  192. msgstr ""
  193. #: ../../../docs/quick-start.md:71
  194. msgid ""
  195. "It will fetch the playbook to a new `matrix-docker-ansible-deploy` "
  196. "directory underneath the directory you are currently in."
  197. msgstr ""
  198. #: ../../../docs/quick-start.md:73
  199. msgid "Configure the playbook"
  200. msgstr ""
  201. #: ../../../docs/quick-start.md:75
  202. msgid ""
  203. "<sup>This section is optimized for this quick-start guide and is derived "
  204. "from the following full-documentation page: [Configuring the playbook"
  205. "](configuring-playbook.md)</sup>"
  206. msgstr ""
  207. #: ../../../docs/quick-start.md:77
  208. msgid ""
  209. "Now that the playbook was fetched, it is time to **configure** it per "
  210. "your needs."
  211. msgstr ""
  212. #: ../../../docs/quick-start.md:79
  213. msgid ""
  214. "To install Matrix services with this playbook, you would at least need 2 "
  215. "configuration files."
  216. msgstr ""
  217. #: ../../../docs/quick-start.md:81
  218. msgid ""
  219. "For your convenience, we have prepared example files of them "
  220. "([`vars.yml`](../examples/vars.yml) and [`hosts`](../examples/hosts))."
  221. msgstr ""
  222. #: ../../../docs/quick-start.md:83
  223. msgid ""
  224. "To start quickly based on these example files, go into the `matrix-"
  225. "docker-ansible-deploy` directory and follow the instructions below:"
  226. msgstr ""
  227. #: ../../../docs/quick-start.md:85
  228. msgid ""
  229. "Create a directory to hold your configuration: `mkdir -p "
  230. "inventory/host_vars/matrix.example.com` where `example.com` is your "
  231. "\"base domain\""
  232. msgstr ""
  233. #: ../../../docs/quick-start.md:86
  234. msgid ""
  235. "Copy the sample configuration file: `cp examples/vars.yml "
  236. "inventory/host_vars/matrix.example.com/vars.yml`"
  237. msgstr ""
  238. #: ../../../docs/quick-start.md:87
  239. msgid "Copy the sample inventory hosts file: `cp examples/hosts inventory/hosts`"
  240. msgstr ""
  241. #: ../../../docs/quick-start.md:88
  242. msgid ""
  243. "Edit the configuration file "
  244. "(`inventory/host_vars/matrix.example.com/vars.yml`)"
  245. msgstr ""
  246. #: ../../../docs/quick-start.md:89
  247. msgid "Edit the inventory hosts file (`inventory/hosts`)"
  248. msgstr ""
  249. #: ../../../docs/quick-start.md:91
  250. msgid ""
  251. "Before editing these 2 files, make sure to read explanations on them to "
  252. "understand what needs to be configured."
  253. msgstr ""
  254. #: ../../../docs/quick-start.md:93
  255. msgid "**💡 Notes:**"
  256. msgstr ""
  257. #: ../../../docs/quick-start.md:94
  258. msgid ""
  259. "If you are not in control of anything on the base domain, you would need "
  260. "to set additional configuration on `vars.yml`. For more information, see "
  261. "[How do I install on matrix.example.com without involving the base "
  262. "domain?](faq.md#how-do-i-install-on-matrix-example-com-without-involving-"
  263. "the-base-domain) on our FAQ."
  264. msgstr ""
  265. #: ../../../docs/quick-start.md:95
  266. msgid ""
  267. "Certain configuration decisions (like the base domain configured in "
  268. "`matrix_domain` and homeserver implementation configured in "
  269. "`matrix_homeserver_implementation`) are final. If you make the wrong "
  270. "choice and wish to change it, you'll have to run the Uninstalling step "
  271. "and start over."
  272. msgstr ""
  273. #: ../../../docs/quick-start.md:96
  274. msgid ""
  275. "Instead of configuring a lot of things all at once, we recommend starting"
  276. " with the basic (default) settings in order to get yourself familiar with"
  277. " how the playbook works. After making sure that everything works as "
  278. "expected, you can add (and remove) advanced settings / features and run "
  279. "the playbook as many times as you wish."
  280. msgstr ""
  281. #: ../../../docs/quick-start.md:98
  282. msgid "Install"
  283. msgstr ""
  284. #: ../../../docs/quick-start.md:100
  285. msgid ""
  286. "<sup>This section is optimized for this quick-start guide and is derived "
  287. "from the following full-documentation page: "
  288. "[Installing](installing.md)</sup>"
  289. msgstr ""
  290. #: ../../../docs/quick-start.md:102
  291. msgid ""
  292. "After editing `vars.yml` and `hosts` files, let's start the "
  293. "**installation** procedure."
  294. msgstr ""
  295. #: ../../../docs/quick-start.md:104
  296. msgid "Update Ansible roles"
  297. msgstr ""
  298. #: ../../../docs/quick-start.md:106
  299. msgid ""
  300. "Before installing, you need to update the Ansible roles that this "
  301. "playbook uses and fetches from outside."
  302. msgstr ""
  303. #: ../../../docs/quick-start.md:108
  304. msgid "To update your playbook directory and all upstream Ansible roles, run:"
  305. msgstr ""
  306. #: ../../../docs/quick-start.md:110
  307. msgid "either: `just update`"
  308. msgstr ""
  309. #: ../../../docs/quick-start.md:111
  310. msgid ""
  311. "or: a combination of `git pull` and `just roles` (or `make roles` if you "
  312. "have `make` program on your computer instead of `just`)"
  313. msgstr ""
  314. #: ../../../docs/quick-start.md:113
  315. msgid ""
  316. "If you don't have either `just` tool or `make` program, you can run the "
  317. "`ansible-galaxy` tool directly: `rm -rf roles/galaxy; ansible-galaxy "
  318. "install -r requirements.yml -p roles/galaxy/ --force`"
  319. msgstr ""
  320. #: ../../../docs/quick-start.md:115
  321. msgid "Run installation command"
  322. msgstr ""
  323. #: ../../../docs/quick-start.md:117
  324. msgid "Then, run the command below to start installation:"
  325. msgstr ""
  326. #: ../../../docs/quick-start.md:123
  327. msgid ""
  328. "If you **don't** use SSH keys for authentication, but rather a regular "
  329. "password, you may need to add `--ask-pass` to the command."
  330. msgstr ""
  331. #: ../../../docs/quick-start.md:125
  332. msgid ""
  333. "If you **do** use SSH keys for authentication, **and** use a non-root "
  334. "user to *become* root (sudo), you may need to add `-K` (`--ask-become-"
  335. "pass`) to the command."
  336. msgstr ""
  337. #: ../../../docs/quick-start.md:127
  338. msgid ""
  339. "Wait until the command completes. If it's all green, everything should be"
  340. " running properly."
  341. msgstr ""
  342. #: ../../../docs/quick-start.md:129
  343. msgid "Create your user account"
  344. msgstr ""
  345. #: ../../../docs/quick-start.md:131
  346. msgid ""
  347. "<sup>This section is optimized for this quick-start guide and is derived "
  348. "from the following full-documentation page: [Registering users"
  349. "](registering-users.md)</sup>"
  350. msgstr ""
  351. #: ../../../docs/quick-start.md:133
  352. msgid ""
  353. "As you have configured your brand new server and the client, you need to "
  354. "**create your user account** on your Matrix server."
  355. msgstr ""
  356. #: ../../../docs/quick-start.md:135
  357. msgid ""
  358. "To create your user account (as an administrator of the server) via this "
  359. "Ansible playbook, run the command below on your local computer."
  360. msgstr ""
  361. #: ../../../docs/quick-start.md:137
  362. msgid "**💡 Notes**:"
  363. msgstr ""
  364. #: ../../../docs/quick-start.md:138
  365. msgid "Make sure to adjust `YOUR_USERNAME_HERE` and `YOUR_PASSWORD_HERE`"
  366. msgstr ""
  367. #: ../../../docs/quick-start.md:139
  368. msgid ""
  369. "For `YOUR_USERNAME_HERE`, use a plain username like `alice`, not your "
  370. "full ID (`@alice:example.com`)"
  371. msgstr ""
  372. #: ../../../docs/quick-start.md:151
  373. msgid "Finalize server installation"
  374. msgstr ""
  375. #: ../../../docs/quick-start.md:153
  376. msgid ""
  377. "<sup>This section is optimized for this quick-start guide and is derived "
  378. "from the following full-documentation page: [Server Delegation](howto-"
  379. "server-delegation.md)</sup>"
  380. msgstr ""
  381. #: ../../../docs/quick-start.md:155
  382. msgid ""
  383. "Now that you've configured Matrix services and your user account, you "
  384. "need to **finalize the installation process** by [setting up Matrix "
  385. "delegation (redirection)](howto-server-delegation.md), so that your "
  386. "Matrix server (`matrix.example.com`) can present itself as the base "
  387. "domain (`example.com`) in the Matrix network."
  388. msgstr ""
  389. #: ../../../docs/quick-start.md:157
  390. msgid ""
  391. "**This is required for federation to work!** Without a proper "
  392. "configuration, your server will effectively not be part of the Matrix "
  393. "network."
  394. msgstr ""
  395. #: ../../../docs/quick-start.md:159
  396. msgid ""
  397. "To configure the delegation, you have these two options. Choose one of "
  398. "them according to your situation."
  399. msgstr ""
  400. #: ../../../docs/quick-start.md:161
  401. msgid ""
  402. "If you can afford to point the base domain at the Matrix server, follow "
  403. "the instruction below which guides you into [serving the base domain"
  404. "](configuring-playbook-base-domain-serving.md) from the integrated web "
  405. "server."
  406. msgstr ""
  407. #: ../../../docs/quick-start.md:162
  408. msgid ""
  409. "Alternatively, if you're using the base domain for other purposes and "
  410. "cannot point it to the Matrix server (and thus cannot \"serve the base "
  411. "domain\" from it), you most likely need to [manually install well-known "
  412. "files on the base domain's server](configuring-well-known.md#manually-"
  413. "installing-well-known-files-on-the-base-domains-server)."
  414. msgstr ""
  415. #: ../../../docs/quick-start.md:164
  416. msgid ""
  417. "To have the base domain served from the integrated web server, add the "
  418. "following configuration to your "
  419. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  420. msgstr ""
  421. #: ../../../docs/quick-start.md:170
  422. msgid ""
  423. "After configuring the playbook, run the command below and wait until it "
  424. "finishes:"
  425. msgstr ""
  426. #: ../../../docs/quick-start.md:176
  427. msgid ""
  428. "💡 Running the `install-matrix-static-files` playbook tag (as done here) "
  429. "is an optimized version of running [the full setup command](#run-"
  430. "installation-command)."
  431. msgstr ""
  432. #: ../../../docs/quick-start.md:178
  433. msgid ""
  434. "After the command finishes, you can also check whether your server "
  435. "federates with the Matrix network by using the [Federation "
  436. "Tester](https://federationtester.matrix.org/) against your base domain "
  437. "(`example.com`), not the `matrix.example.com` subdomain."
  438. msgstr ""
  439. #: ../../../docs/quick-start.md:180
  440. msgid "Re-run the full setup command any time"
  441. msgstr ""
  442. #: ../../../docs/quick-start.md:182
  443. msgid ""
  444. "If you think something is wrong with the server configuration, feel free "
  445. "to re-run the setup command any time:"
  446. msgstr ""
  447. #: ../../../docs/quick-start.md:188
  448. msgid "Log in to your user account"
  449. msgstr ""
  450. #: ../../../docs/quick-start.md:190
  451. msgid ""
  452. "Finally, let's make sure that you can log in to the created account with "
  453. "the specified password."
  454. msgstr ""
  455. #: ../../../docs/quick-start.md:192
  456. msgid ""
  457. "You should be able to log in to it with your own [Element Web"
  458. "](configuring-playbook-client-element-web.md) client which you have set "
  459. "up at `element.example.com` by running the playbook. Open the URL "
  460. "(`https://element.example.com`) in a web browser and enter your "
  461. "credentials to log in."
  462. msgstr ""
  463. #: ../../../docs/quick-start.md:194
  464. msgid ""
  465. "**If you successfully logged in to your account, installing and "
  466. "configuring is complete**🎉"
  467. msgstr ""
  468. #: ../../../docs/quick-start.md:196
  469. msgid ""
  470. "Come say Hi👋 in our support room - [#matrix-docker-ansible-"
  471. "deploy:devture.com](https://matrix.to/#/#matrix-docker-ansible-"
  472. "deploy:devture.com). You might learn something or get to help someone "
  473. "else new to Matrix hosting."
  474. msgstr ""
  475. #: ../../../docs/quick-start.md:198
  476. msgid "Things to do next"
  477. msgstr ""
  478. #: ../../../docs/quick-start.md:200
  479. msgid ""
  480. "Once you get familiar with the playbook, you might probably want to set "
  481. "up additional services such as a bridge on your server."
  482. msgstr ""
  483. #: ../../../docs/quick-start.md:202
  484. msgid ""
  485. "As this page intends to be a quick start guide which explains how to "
  486. "start the core Matrix services, it does not cover a topic like how to set"
  487. " them up. Take a look at the list of [things to do next](installing.md"
  488. "#things-to-do-next) to learn more."
  489. msgstr ""
  490. #: ../../../docs/quick-start.md:204
  491. msgid "⚠️Keep the playbook and services up-to-date"
  492. msgstr ""
  493. #: ../../../docs/quick-start.md:206
  494. msgid ""
  495. "While this playbook helps you to set up Matrix services and maintain "
  496. "them, it will **not** automatically run the maintenance task for you. You"
  497. " will need to update the playbook and re-run it **manually**."
  498. msgstr ""
  499. #: ../../../docs/quick-start.md:208
  500. msgid ""
  501. "Since it is unsafe to keep outdated services running on the server "
  502. "connected to the internet, please consider to update the playbook and re-"
  503. "run it periodically, in order to keep the services up-to-date."
  504. msgstr ""
  505. #: ../../../docs/quick-start.md:210
  506. msgid ""
  507. "For more information about upgrading or maintaining services with the "
  508. "playbook, take at look at this page: [Upgrading the Matrix services"
  509. "](maintenance-upgrading-services.md)"
  510. msgstr ""