overmind
/
matrix-docker-ansible-deploy
зеркало из https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Форкнуть 0
Код Задачи 0 Релизы 0 Вики Активность
Matrix Docker Ansible eploy
Вы не можете выбрать более 25 тем Темы должны начинаться с буквы или цифры, могут содержать дефисы(-) и должны содержать не более 35 символов.
10427 коммитов
15 Ветки
107 MiB
 
 
Дерево: 90d3cf78b3
Ветки Теги
${ item.name }
Создать ветку ${ searchTerm }
из '90d3cf78b3'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/jp/LC_MESSAGES/docs/quick-start.po

434 строки
17 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: 2025-01-27 09:54+0200\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/quick-start.md:1

  24. msgid "Quick start"

  25. msgstr ""

  26. 

  27. #: ../../../docs/quick-start.md:9

  28. msgid "This page explains how to use this Ansible playbook to install Matrix services on your server with a minimal set of core services."

  29. msgstr ""

  30. 

  31. #: ../../../docs/quick-start.md:11

  32. msgid "We will be using `example.com` as the \"base domain\" in the following instruction."

  33. msgstr ""

  34. 

  35. #: ../../../docs/quick-start.md:13

  36. msgid "By following the instruction on this page, you will set up:"

  37. msgstr ""

  38. 

  39. #: ../../../docs/quick-start.md:15

  40. msgid "**your own Matrix server** on a `matrix.example.com` server, which is configured to present itself as `example.com`"

  41. msgstr ""

  42. 

  43. #: ../../../docs/quick-start.md:16

  44. msgid "**your user account** like `@alice:example.com` on the server"

  45. msgstr ""

  46. 

  47. #: ../../../docs/quick-start.md:17

  48. msgid "a **self-hosted Matrix client**, [Element Web](configuring-playbook-client-element-web.md) with the default subdomain at `element.example.com`"

  49. msgstr ""

  50. 

  51. #: ../../../docs/quick-start.md:18

  52. msgid "Matrix delegation, so that your `matrix.example.com` server (presenting itself as `example.com`) can join the Matrix Federation and communicate with any other server in the Matrix network"

  53. msgstr ""

  54. 

  55. #: ../../../docs/quick-start.md:20

  56. msgid "Please remember to replace `example.com` with your own domain before running any commands."

  57. msgstr ""

  58. 

  59. #: ../../../docs/quick-start.md:22

  60. msgid "Prerequisites"

  61. msgstr ""

  62. 

  63. #: ../../../docs/quick-start.md:24

  64. msgid "<sup>This section is optimized for this quick-start guide and is derived from the following full-documentation page: [Prerequisites](prerequisites.md)</sup>"

  65. msgstr ""

  66. 

  67. #: ../../../docs/quick-start.md:26

  68. msgid "At first, **check prerequisites** and prepare for installation by setting up programs [on your own computer](prerequisites.md#your-local-computer) and [your server](prerequisites.md#server). You also need `root` access on your server (a user that could elevate to `root` via `sudo` also works)."

  69. msgstr ""

  70. 

  71. #: ../../../docs/quick-start.md:28

  72. msgid "When preparing your server, make sure to check [the server specs you need](faq.md#what-kind-of-server-specs-do-i-need). We recommend starting with a server having at least 2GB of memory."

  73. msgstr ""

  74. 

  75. #: ../../../docs/quick-start.md:34

  76. msgid "If you encounter an error during installation, please make sure that you have installed and configured programs correctly."

  77. msgstr ""

  78. 

  79. #: ../../../docs/quick-start.md:36

  80. msgid "One of the main reasons of basic errors is using an incompatible version of required software such as Ansible. Take a look at [our guide about Ansible](ansible.md) for more information. In short: installing the latest available version is recommended."

  81. msgstr ""

  82. 

  83. #: ../../../docs/quick-start.md:38

  84. msgid "Configure your DNS settings"

  85. msgstr ""

  86. 

  87. #: ../../../docs/quick-start.md:40

  88. msgid "<sup>This section is optimized for this quick-start guide and is derived from the following full-documentation page: [Configuring your DNS settings](configuring-dns.md)</sup>"

  89. msgstr ""

  90. 

  91. #: ../../../docs/quick-start.md:42

  92. msgid "After installing and configuring prerequisites, you will need to **configure DNS records**."

  93. msgstr ""

  94. 

  95. #: ../../../docs/quick-start.md:44

  96. msgid "To configure Matrix services in the default settings, go to your DNS service provider, and adjust DNS records as below."

  97. msgstr ""

  98. 

  99. #: ../../../docs/quick-start.md

  100. msgid "Type"

  101. msgstr ""

  102. 

  103. #: ../../../docs/quick-start.md

  104. msgid "Host"

  105. msgstr ""

  106. 

  107. #: ../../../docs/quick-start.md

  108. msgid "Priority"

  109. msgstr ""

  110. 

  111. #: ../../../docs/quick-start.md

  112. msgid "Weight"

  113. msgstr ""

  114. 

  115. #: ../../../docs/quick-start.md

  116. msgid "Port"

  117. msgstr ""

  118. 

  119. #: ../../../docs/quick-start.md

  120. msgid "Target"

  121. msgstr ""

  122. 

  123. #: ../../../docs/quick-start.md

  124. msgid "A"

  125. msgstr ""

  126. 

  127. #: ../../../docs/quick-start.md

  128. msgid "`matrix`"

  129. msgstr ""

  130. 

  131. #: ../../../docs/quick-start.md

  132. msgid "-"

  133. msgstr ""

  134. 

  135. #: ../../../docs/quick-start.md

  136. msgid "`matrix-server-IP`"

  137. msgstr ""

  138. 

  139. #: ../../../docs/quick-start.md

  140. msgid "CNAME"

  141. msgstr ""

  142. 

  143. #: ../../../docs/quick-start.md

  144. msgid "`element`"

  145. msgstr ""

  146. 

  147. #: ../../../docs/quick-start.md

  148. msgid "`matrix.example.com`"

  149. msgstr ""

  150. 

  151. #: ../../../docs/quick-start.md:51

  152. msgid "As the table illustrates, you need to create 2 subdomains (`matrix.example.com` and `element.example.com`) and point both of them to your server's IP address (DNS `A` record or `CNAME` record is fine)."

  153. msgstr ""

  154. 

  155. #: ../../../docs/quick-start.md:53

  156. msgid "It might take some time for the DNS records to propagate after creation."

  157. msgstr ""

  158. 

  159. #: ../../../docs/quick-start.md:55

  160. msgid "**💡 Note**: if you are using Cloudflare DNS, make sure to disable the proxy and set all records to \"DNS only\""

  161. msgstr ""

  162. 

  163. #: ../../../docs/quick-start.md:57

  164. msgid "Get the playbook"

  165. msgstr ""

  166. 

  167. #: ../../../docs/quick-start.md:59

  168. msgid "<sup>This section is optimized for this quick-start guide and is derived from the following full-documentation page: [Getting the playbook](getting-the-playbook.md)</sup>"

  169. msgstr ""

  170. 

  171. #: ../../../docs/quick-start.md:61

  172. msgid "Next, let's **get the playbook's source code**."

  173. msgstr ""

  174. 

  175. #: ../../../docs/quick-start.md:63

  176. msgid "We recommend to do so with [git](https://git-scm.com/) as it enables you to keep it up to date with the latest source code. While it is possible to download the playbook as a ZIP archive, it is not recommended."

  177. msgstr ""

  178. 

  179. #: ../../../docs/quick-start.md:65

  180. msgid "To get the playbook with git, install git on your computer, go to a directory, and run the command:"

  181. msgstr ""

  182. 

  183. #: ../../../docs/quick-start.md:71

  184. msgid "It will fetch the playbook to a new `matrix-docker-ansible-deploy` directory underneath the directory you are currently in."

  185. msgstr ""

  186. 

  187. #: ../../../docs/quick-start.md:73

  188. msgid "Configure the playbook"

  189. msgstr ""

  190. 

  191. #: ../../../docs/quick-start.md:75

  192. msgid "<sup>This section is optimized for this quick-start guide and is derived from the following full-documentation page: [Configuring the playbook](configuring-playbook.md)</sup>"

  193. msgstr ""

  194. 

  195. #: ../../../docs/quick-start.md:77

  196. msgid "Now that the playbook was fetched, it is time to **configure** it per your needs."

  197. msgstr ""

  198. 

  199. #: ../../../docs/quick-start.md:79

  200. msgid "To install Matrix services with this playbook, you would at least need 2 configuration files."

  201. msgstr ""

  202. 

  203. #: ../../../docs/quick-start.md:81

  204. msgid "For your convenience, we have prepared example files of them ([`vars.yml`](../examples/vars.yml) and [`hosts`](../examples/hosts))."

  205. msgstr ""

  206. 

  207. #: ../../../docs/quick-start.md:83

  208. msgid "To start quickly based on these example files, go into the `matrix-docker-ansible-deploy` directory and follow the instructions below:"

  209. msgstr ""

  210. 

  211. #: ../../../docs/quick-start.md:85

  212. msgid "Create a directory to hold your configuration: `mkdir -p inventory/host_vars/matrix.example.com` where `example.com` is your \"base domain\""

  213. msgstr ""

  214. 

  215. #: ../../../docs/quick-start.md:86

  216. msgid "Copy the sample configuration file: `cp examples/vars.yml inventory/host_vars/matrix.example.com/vars.yml`"

  217. msgstr ""

  218. 

  219. #: ../../../docs/quick-start.md:87

  220. msgid "Copy the sample inventory hosts file: `cp examples/hosts inventory/hosts`"

  221. msgstr ""

  222. 

  223. #: ../../../docs/quick-start.md:88

  224. msgid "Edit the configuration file (`inventory/host_vars/matrix.example.com/vars.yml`)"

  225. msgstr ""

  226. 

  227. #: ../../../docs/quick-start.md:89

  228. msgid "Edit the inventory hosts file (`inventory/hosts`)"

  229. msgstr ""

  230. 

  231. #: ../../../docs/quick-start.md:91

  232. msgid "Before editing these 2 files, make sure to read explanations on them to understand what needs to be configured."

  233. msgstr ""

  234. 

  235. #: ../../../docs/quick-start.md:93

  236. msgid "**💡 Notes:**"

  237. msgstr ""

  238. 

  239. #: ../../../docs/quick-start.md:94

  240. msgid "If you are not in control of anything on the base domain, you would need to set additional configuration on `vars.yml`. For more information, see [How do I install on matrix.example.com without involving the base domain?](faq.md#how-do-i-install-on-matrix-example-com-without-involving-the-base-domain) on our FAQ."

  241. msgstr ""

  242. 

  243. #: ../../../docs/quick-start.md:95

  244. msgid "Certain configuration decisions (like the base domain configured in `matrix_domain` and homeserver implementation configured in `matrix_homeserver_implementation`) are final. If you make the wrong choice and wish to change it, you'll have to run the Uninstalling step and start over."

  245. msgstr ""

  246. 

  247. #: ../../../docs/quick-start.md:96

  248. msgid "Instead of configuring a lot of things all at once, we recommend starting with the basic (default) settings in order to get yourself familiar with how the playbook works. After making sure that everything works as expected, you can add (and remove) advanced settings / features and run the playbook as many times as you wish."

  249. msgstr ""

  250. 

  251. #: ../../../docs/quick-start.md:98

  252. msgid "Install"

  253. msgstr ""

  254. 

  255. #: ../../../docs/quick-start.md:100

  256. msgid "<sup>This section is optimized for this quick-start guide and is derived from the following full-documentation page: [Installing](installing.md)</sup>"

  257. msgstr ""

  258. 

  259. #: ../../../docs/quick-start.md:102

  260. msgid "After editing `vars.yml` and `hosts` files, let's start the **installation** procedure."

  261. msgstr ""

  262. 

  263. #: ../../../docs/quick-start.md:104

  264. msgid "Update Ansible roles"

  265. msgstr ""

  266. 

  267. #: ../../../docs/quick-start.md:106

  268. msgid "Before installing, you need to update the Ansible roles that this playbook uses and fetches from outside."

  269. msgstr ""

  270. 

  271. #: ../../../docs/quick-start.md:108

  272. msgid "To update your playbook directory and all upstream Ansible roles, run:"

  273. msgstr ""

  274. 

  275. #: ../../../docs/quick-start.md:110

  276. msgid "either: `just update`"

  277. msgstr ""

  278. 

  279. #: ../../../docs/quick-start.md:111

  280. msgid "or: a combination of `git pull` and `just roles` (or `make roles` if you have `make` program on your computer instead of `just`)"

  281. msgstr ""

  282. 

  283. #: ../../../docs/quick-start.md:113

  284. msgid "If you don't have either `just` tool or `make` program, you can run the `ansible-galaxy` tool directly: `rm -rf roles/galaxy; ansible-galaxy install -r requirements.yml -p roles/galaxy/ --force`"

  285. msgstr ""

  286. 

  287. #: ../../../docs/quick-start.md:115

  288. msgid "Run installation command"

  289. msgstr ""

  290. 

  291. #: ../../../docs/quick-start.md:117

  292. msgid "Then, run the command below to start installation:"

  293. msgstr ""

  294. 

  295. #: ../../../docs/quick-start.md:123

  296. msgid "If you **don't** use SSH keys for authentication, but rather a regular password, you may need to add `--ask-pass` to the command."

  297. msgstr ""

  298. 

  299. #: ../../../docs/quick-start.md:125

  300. msgid "If you **do** use SSH keys for authentication, **and** use a non-root user to *become* root (sudo), you may need to add `-K` (`--ask-become-pass`) to the command."

  301. msgstr ""

  302. 

  303. #: ../../../docs/quick-start.md:127

  304. msgid "Wait until the command completes. If it's all green, everything should be running properly."

  305. msgstr ""

  306. 

  307. #: ../../../docs/quick-start.md:129

  308. msgid "Create your user account"

  309. msgstr ""

  310. 

  311. #: ../../../docs/quick-start.md:131

  312. msgid "<sup>This section is optimized for this quick-start guide and is derived from the following full-documentation page: [Registering users](registering-users.md)</sup>"

  313. msgstr ""

  314. 

  315. #: ../../../docs/quick-start.md:133

  316. msgid "As you have configured your brand new server and the client, you need to **create your user account** on your Matrix server."

  317. msgstr ""

  318. 

  319. #: ../../../docs/quick-start.md:135

  320. msgid "To create your user account (as an administrator of the server) via this Ansible playbook, run the command below on your local computer."

  321. msgstr ""

  322. 

  323. #: ../../../docs/quick-start.md:137

  324. msgid "**💡 Notes**:"

  325. msgstr ""

  326. 

  327. #: ../../../docs/quick-start.md:138

  328. msgid "Make sure to adjust `YOUR_USERNAME_HERE` and `YOUR_PASSWORD_HERE`"

  329. msgstr ""

  330. 

  331. #: ../../../docs/quick-start.md:139

  332. msgid "For `YOUR_USERNAME_HERE`, use a plain username like `alice`, not your full ID (`@alice:example.com`)"

  333. msgstr ""

  334. 

  335. #: ../../../docs/quick-start.md:151

  336. msgid "Finalize server installation"

  337. msgstr ""

  338. 

  339. #: ../../../docs/quick-start.md:153

  340. msgid "<sup>This section is optimized for this quick-start guide and is derived from the following full-documentation page: [Server Delegation](howto-server-delegation.md)</sup>"

  341. msgstr ""

  342. 

  343. #: ../../../docs/quick-start.md:155

  344. msgid "Now that you've configured Matrix services and your user account, you need to **finalize the installation process** by [setting up Matrix delegation (redirection)](howto-server-delegation.md), so that your Matrix server (`matrix.example.com`) can present itself as the base domain (`example.com`) in the Matrix network."

  345. msgstr ""

  346. 

  347. #: ../../../docs/quick-start.md:157

  348. msgid "**This is required for federation to work!** Without a proper configuration, your server will effectively not be part of the Matrix network."

  349. msgstr ""

  350. 

  351. #: ../../../docs/quick-start.md:159

  352. msgid "To configure the delegation, you have these two options. Choose one of them according to your situation."

  353. msgstr ""

  354. 

  355. #: ../../../docs/quick-start.md:161

  356. msgid "If you can afford to point the base domain at the Matrix server, follow the instruction below which guides you into [serving the base domain](configuring-playbook-base-domain-serving.md) from the integrated web server."

  357. msgstr ""

  358. 

  359. #: ../../../docs/quick-start.md:162

  360. msgid "Alternatively, if you're using the base domain for other purposes and cannot point it to the Matrix server (and thus cannot \"serve the base domain\" from it), you most likely need to [manually install well-known files on the base domain's server](configuring-well-known.md#manually-installing-well-known-files-on-the-base-domains-server)."

  361. msgstr ""

  362. 

  363. #: ../../../docs/quick-start.md:164

  364. msgid "To have the base domain served from the integrated web server, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"

  365. msgstr ""

  366. 

  367. #: ../../../docs/quick-start.md:170

  368. msgid "After configuring the playbook, run the command below and wait until it finishes:"

  369. msgstr ""

  370. 

  371. #: ../../../docs/quick-start.md:176

  372. msgid "💡 Running the `install-matrix-static-files` playbook tag (as done here) is an optimized version of running [the full setup command](#run-installation-command)."

  373. msgstr ""

  374. 

  375. #: ../../../docs/quick-start.md:178

  376. msgid "After the command finishes, you can also check whether your server federates with the Matrix network by using the [Federation Tester](https://federationtester.matrix.org/) against your base domain (`example.com`), not the `matrix.example.com` subdomain."

  377. msgstr ""

  378. 

  379. #: ../../../docs/quick-start.md:180

  380. msgid "Re-run the full setup command any time"

  381. msgstr ""

  382. 

  383. #: ../../../docs/quick-start.md:182

  384. msgid "If you think something is wrong with the server configuration, feel free to re-run the setup command any time:"

  385. msgstr ""

  386. 

  387. #: ../../../docs/quick-start.md:188

  388. msgid "Log in to your user account"

  389. msgstr ""

  390. 

  391. #: ../../../docs/quick-start.md:190

  392. msgid "Finally, let's make sure that you can log in to the created account with the specified password."

  393. msgstr ""

  394. 

  395. #: ../../../docs/quick-start.md:192

  396. msgid "You should be able to log in to it with your own [Element Web](configuring-playbook-client-element-web.md) client which you have set up at `element.example.com` by running the playbook. Open the URL (`https://element.example.com`) in a web browser and enter your credentials to log in."

  397. msgstr ""

  398. 

  399. #: ../../../docs/quick-start.md:194

  400. msgid "**If you successfully logged in to your account, installing and configuring is complete**🎉"

  401. msgstr ""

  402. 

  403. #: ../../../docs/quick-start.md:196

  404. msgid "Come say Hi👋 in our support room — [#matrix-docker-ansible-deploy:devture.com](https://matrix.to/#/#matrix-docker-ansible-deploy:devture.com). You might learn something or get to help someone else new to Matrix hosting."

  405. msgstr ""

  406. 

  407. #: ../../../docs/quick-start.md:198

  408. msgid "Things to do next"

  409. msgstr ""

  410. 

  411. #: ../../../docs/quick-start.md:200

  412. msgid "Once you get familiar with the playbook, you might probably want to set up additional services such as a bridge on your server."

  413. msgstr ""

  414. 

  415. #: ../../../docs/quick-start.md:202

  416. msgid "As this page intends to be a quick start guide which explains how to start the core Matrix services, it does not cover a topic like how to set them up. Take a look at the list of [things to do next](installing.md#things-to-do-next) to learn more."

  417. msgstr ""

  418. 

  419. #: ../../../docs/quick-start.md:204

  420. msgid "⚠️Keep the playbook and services up-to-date"

  421. msgstr ""

  422. 

  423. #: ../../../docs/quick-start.md:206

  424. msgid "While this playbook helps you to set up Matrix services and maintain them, it will **not** automatically run the maintenance task for you. You will need to update the playbook and re-run it **manually**."

  425. msgstr ""

  426. 

  427. #: ../../../docs/quick-start.md:208

  428. msgid "Since it is unsafe to keep outdated services running on the server connected to the internet, please consider to update the playbook and re-run it periodically, in order to keep the services up-to-date."

  429. msgstr ""

  430. 

  431. #: ../../../docs/quick-start.md:210

  432. msgid "For more information about upgrading or maintaining services with the playbook, take at look at this page: [Upgrading the Matrix services](maintenance-upgrading-services.md)"

  433. msgstr ""