overmind
/
matrix-docker-ansible-deploy
peilaus alkaen https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Fork 0
Koodi Ongelmat 0 Julkaisut 0 Wiki Toiminta
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.
10427 Commitit
11 Branchit
1.0 GiB
 
 
Puu: 90d3cf78b3
Branchit Tagit
${ item.name }
Create branch ${ searchTerm }
from '90d3cf78b3'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/jp/LC_MESSAGES/docs/faq.po

894 rivejä
41 KiB
Raaka Blame Historia 

  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/faq.md:1

  24. msgid "Frequently Asked Questions"

  25. msgstr ""

  26. 

  27. #: ../../../docs/faq.md:3

  28. msgid "This documentation page tries to answer various Frequently Asked Questions about all things [Matrix](https://matrix.org/), with a focus on this [Ansible](https://www.ansible.com/) playbook ([What is Ansible? How does it work?](#what-is-ansible-how-does-it-work))."

  29. msgstr ""

  30. 

  31. #: ../../../docs/faq.md:5

  32. msgid "This FAQ page does not intend to replace the [matrix.org FAQ](https://matrix.org/faq/) (please see that one too)."

  33. msgstr ""

  34. 

  35. #: ../../../docs/faq.md:7

  36. msgid "We've only started this FAQ recently, so it's still somewhat empty."

  37. msgstr ""

  38. 

  39. #: ../../../docs/faq.md:9

  40. msgid "Also, we encourage you to not dig yourself into a hole by reading way too much. When you've heard enough, proceed to installation. To get started, see [below](#how-do-i-run-the-installation) about our installation guides."

  41. msgstr ""

  42. 

  43. #: ../../../docs/faq.md:11

  44. msgid "Introductory"

  45. msgstr ""

  46. 

  47. #: ../../../docs/faq.md:13

  48. msgid "Where do I find more questions and answers about Matrix?"

  49. msgstr ""

  50. 

  51. #: ../../../docs/faq.md:15

  52. msgid "This is a Frequently Asked Questions page focused on this [Ansible](https://www.ansible.com/) playbook ([What is Ansible? How does it work?](#what-is-ansible-how-does-it-work)) for deploying a [Matrix](https://matrix.org/) server."

  53. msgstr ""

  54. 

  55. #: ../../../docs/faq.md:17

  56. msgid "For a lot more generic questions and answers, see the [matrix.org FAQ](https://matrix.org/faq/)."

  57. msgstr ""

  58. 

  59. #: ../../../docs/faq.md:19

  60. msgid "What is Matrix? What is Element? What is Synapse? Why are you confusing me with so many terms?"

  61. msgstr ""

  62. 

  63. #: ../../../docs/faq.md:21

  64. msgid "[Matrix](https://matrix.org/) is a new type of realtime communication (chat) network, the closest analogy to which is probably \"email\"."

  65. msgstr ""

  66. 

  67. #: ../../../docs/faq.md:23

  68. msgid "You don't just use the \"email\" protocols (SMTP, POP3, IMAP) directly though. There's a *server* somewhere which stores your data (`@gmail.com`, `@yahoo.com`, `@hotmail.com`, `@your-company.com`) and you access it by using these \"email\" protocols via some *client* program (Outlook, Thunderbird, some website, etc)."

  69. msgstr ""

  70. 

  71. #: ../../../docs/faq.md:25

  72. msgid "In the world of the Matrix chat protocol, there are various client programs. The first and currently most full-featured one is called [Element](https://element.io/) (used to be called Riot.im and Vector.im in the past). There are [many other clients](https://matrix.org/clients/). You can switch clients as much as you want until you find the one that is right for you on a given platform (you may use Element Desktop on your desktop, but Fluffychat on your phone, etc)."

  73. msgstr ""

  74. 

  75. #: ../../../docs/faq.md:27

  76. msgid "Matrix is also like email due to the fact that there are many servers around the world which can all talk to each other (you can send email from `@gmail.com` addresses to `@yahoo.com` and `@hotmail.com` addresses). It's the same with Matrix (`@bob:example.com` can talk to `@alice:example.org`)."

  77. msgstr ""

  78. 

  79. #: ../../../docs/faq.md:29

  80. msgid "If someone else is hosting your Matrix server (you being `@alice:matrix.org` or some other public server like this), all you need is a Matrix client program, like Element Web or Element X Android."

  81. msgstr ""

  82. 

  83. #: ../../../docs/faq.md:31

  84. msgid "If you'd like to host your own server (you being `@alice:example.com`), you'd need to set up a Matrix server program, like Synapse."

  85. msgstr ""

  86. 

  87. #: ../../../docs/faq.md:33

  88. msgid "In short:"

  89. msgstr ""

  90. 

  91. #: ../../../docs/faq.md:35

  92. msgid "Matrix is the protocol — a set of rules about how the chat network operates"

  93. msgstr ""

  94. 

  95. #: ../../../docs/faq.md:36

  96. msgid "Element is a client program you can use to participate on the Matrix chat network via some server (yours or someone else's). There are also [many other client programs](https://matrix.org/clients/)."

  97. msgstr ""

  98. 

  99. #: ../../../docs/faq.md:37

  100. msgid "Synapse is a server program you can use to host your very own Matrix server."

  101. msgstr ""

  102. 

  103. #: ../../../docs/faq.md:39

  104. msgid "This FAQ here mostly focuses on installing various Matrix services using the Ansible automation tool. You can learn much more about Matrix in the [matrix.org FAQ](https://matrix.org/faq/)."

  105. msgstr ""

  106. 

  107. #: ../../../docs/faq.md:41

  108. msgid "People I wish to talk to are not on Matrix. Can I talk to them?"

  109. msgstr ""

  110. 

  111. #: ../../../docs/faq.md:43

  112. msgid "You most likely can. Besides Matrix-native chats, Matrix also supports the concept of \"bridging\", which allows you to plug other networks into it."

  113. msgstr ""

  114. 

  115. #: ../../../docs/faq.md:45

  116. msgid "This Ansible playbook can help you install [tens of bridges for various networks](configuring-playbook.md#bridging-other-networks)."

  117. msgstr ""

  118. 

  119. #: ../../../docs/faq.md:47

  120. msgid "Besides setting up your own bridges (preferable), you can also use some [public bridges hosted by others](https://publiclist.anchel.nl/#bridges)."

  121. msgstr ""

  122. 

  123. #: ../../../docs/faq.md:49

  124. msgid "How do I get started with Matrix?"

  125. msgstr ""

  126. 

  127. #: ../../../docs/faq.md:51

  128. msgid "One of [Matrix](https://matrix.org/)'s distinguishing strengths (compared to other chat networks) is its decentralized nature. There's not just one entity (company, organization) controlling the servers. Rather there's thousands of servers operated by different people — one server being insecure, slow or disrespective toward its users does not affect the rest of the network. To participate in that decentralization in its fullest, consider hosting your own server or using some public server other than the largest/default one (`matrix.org`)."

  129. msgstr ""

  130. 

  131. #: ../../../docs/faq.md:53

  132. msgid "There are 3 ways to get into Matrix, depending on your technical ability and needs:"

  133. msgstr ""

  134. 

  135. #: ../../../docs/faq.md:55

  136. msgid "**using the existing default server** — the easiest way is to use an existing server. The largest public Matrix server is `matrix.org` and it's configured as a default server in clients such as [Element Web](https://app.element.io) and many others. Just use Element Web on the browser via that link (or [download client apps for your Desktop or smartphone](https://element.io/app-for-productivity)), create an account and start chatting."

  137. msgstr ""

  138. 

  139. #: ../../../docs/faq.md:57

  140. msgid "**using some other server** — instead of using the largest public server (`matrix.org`), you can use another public one. Here's a [list of public Matrix servers](https://joinmatrix.org/servers/) to choose from. Go to [Element Web](https://app.element.io) or download [some other client](https://matrix.org/clients/) of your choosing and adjust the homeserver URL during login."

  141. msgstr ""

  142. 

  143. #: ../../../docs/faq.md:59

  144. msgid "**using your own server** — running your own server puts you in ultimate control of your data. It also lets you have your own user IDs (e.g. `@bob:example.com`). See [How do I set up my own Matrix server](#how-do-i-set-up-my-own-matrix-server)."

  145. msgstr ""

  146. 

  147. #: ../../../docs/faq.md:61

  148. msgid "How do I set up my own Matrix server?"

  149. msgstr ""

  150. 

  151. #: ../../../docs/faq.md:63

  152. msgid "Normally, you'd first choose the [Matrix](https://matrix.org/) server software you'd like to run. At the time of this writing (January/2021), there's only one fully-featured server program, so there's only one reasonable choice. That's [Synapse](https://github.com/element-hq/synapse)."

  153. msgstr ""

  154. 

  155. #: ../../../docs/faq.md:65

  156. msgid "There are [many guides about installing Synapse](https://matrix.org/docs/guides/#installing-synapse). Using this Ansible playbook is just one way of doing it."

  157. msgstr ""

  158. 

  159. #: ../../../docs/faq.md:67

  160. msgid "Naturally, we're biased, so our usual recommendation is to go with this [Ansible](https://www.ansible.com/) playbook, instead of installing Synapse (and many many other things around it) manually."

  161. msgstr ""

  162. 

  163. #: ../../../docs/faq.md:69

  164. msgid "To get started with the playbook, check out the [Quick start](quick-start.md) or full installation guide (starting at the [Prerequisites](prerequisites.md) page)."

  165. msgstr ""

  166. 

  167. #: ../../../docs/faq.md:71

  168. msgid "What is Ansible? How does it work?"

  169. msgstr ""

  170. 

  171. #: ../../../docs/faq.md:73

  172. msgid "[Ansible](https://www.ansible.com/) is an automation program. This \"playbook\" is a collection of tasks/scripts that will set up a [Matrix](https://matrix.org/) server for you, so you don't have to perform these tasks manually."

  173. msgstr ""

  174. 

  175. #: ../../../docs/faq.md:75

  176. msgid "We have written these automated tasks for you and all you need to do is execute them using the Ansible program."

  177. msgstr ""

  178. 

  179. #: ../../../docs/faq.md:77

  180. msgid "You can install Ansible and this playbook code repository on your own computer and tell it to install Matrix services at the server living at `matrix.example.com`. We recommend installing Ansible on your own computer."

  181. msgstr ""

  182. 

  183. #: ../../../docs/faq.md:79

  184. msgid "Alternatively, you can download Ansible and the playbook itself directly on the `matrix.example.com` server."

  185. msgstr ""

  186. 

  187. #: ../../../docs/faq.md:81

  188. msgid "To learn more, see our [dedicated Ansible documentation page](ansible.md)."

  189. msgstr ""

  190. 

  191. #: ../../../docs/faq.md:83

  192. msgid "What is `just`?"

  193. msgstr ""

  194. 

  195. #: ../../../docs/faq.md:85

  196. msgid "[`just`](https://github.com/casey/just) is a modern command-runner alternative to [make](https://www.gnu.org/software/make/). It can be used to invoke commands with less typing."

  197. msgstr ""

  198. 

  199. #: ../../../docs/faq.md:87

  200. msgid "The `just` utility executes shortcut commands (called \"recipes\"), which invoke `ansible-playbook`, `ansible-galaxy` or [`agru`](https://github.com/etkecc/agru) (depending on what is available in your system). The targets of the recipes are defined in [`justfile`](../justfile)."

  201. msgstr ""

  202. 

  203. #: ../../../docs/faq.md:89

  204. msgid "For details about `just` commands, take a look at: [Running `just` commands](just.md)."

  205. msgstr ""

  206. 

  207. #: ../../../docs/faq.md:91

  208. msgid "The playbook also contains a `Makefile` for the `make` tool, but most of the just recipes are not available as targets in the `Makefile`."

  209. msgstr ""

  210. 

  211. #: ../../../docs/faq.md:93

  212. msgid "Why use this playbook and not install Synapse and other things manually?"

  213. msgstr ""

  214. 

  215. #: ../../../docs/faq.md:95

  216. msgid "There are various guides telling you how easy it is to install [Synapse](https://github.com/element-hq/synapse)."

  217. msgstr ""

  218. 

  219. #: ../../../docs/faq.md:97

  220. msgid "Reading the documentation of this Ansible playbook, you may also be thinking:"

  221. msgstr ""

  222. 

  223. #: ../../../docs/faq.md:99

  224. msgid "I don't know what [Ansible](https://www.ansible.com/) is. I don't know what [Docker](https://www.docker.com/) is. This looks more complicated."

  225. msgstr ""

  226. 

  227. #: ../../../docs/faq.md:101

  228. msgid "… so you may be leaning toward [installing Synapse manually](https://github.com/element-hq/synapse/blob/master/INSTALL.md)."

  229. msgstr ""

  230. 

  231. #: ../../../docs/faq.md:103

  232. msgid "The problem with a manual installation is:"

  233. msgstr ""

  234. 

  235. #: ../../../docs/faq.md:105

  236. msgid "Synapse is written in Python. If not packaged for your distribution, you'd need to install various Python modules, etc., and keep them updated."

  237. msgstr ""

  238. 

  239. #: ../../../docs/faq.md:106

  240. msgid "Synapse requires a [Postgres](https://www.postgresql.org/) database (it can run on SQLite, but that's very much discouraged). So you'd need to install Postgres as well."

  241. msgstr ""

  242. 

  243. #: ../../../docs/faq.md:107

  244. msgid "you may also need a reverse-proxy server in front of it (nginx, Apache), so you'd need to be familiar with that"

  245. msgstr ""

  246. 

  247. #: ../../../docs/faq.md:108

  248. msgid "SSL is required, so you'd need to obtain Let's Encrypt (or other free or non-free) certificates for one or more domain names. You'd need to be familiar with [certbot](https://certbot.eff.org/) (when using Let's Encrypt) or similar software."

  249. msgstr ""

  250. 

  251. #: ../../../docs/faq.md:109

  252. msgid "for each additional component you'd like to add (client like [Element](https://element.io), bridge to some other chat network, integration manager (stickers, other services, Identity Manager, etc.), you'll need to spend extra time installing and wiring it with the rest of the system in a way that works."

  253. msgstr ""

  254. 

  255. #: ../../../docs/faq.md:110

  256. msgid "you'll likely get slower updates for all of these components, depending on your distro packaging or your own time and ability"

  257. msgstr ""

  258. 

  259. #: ../../../docs/faq.md:112

  260. msgid "The playbook, on the other hand, installs a bunch of components for you by default, obtains SSL certificates for you, etc. If you'd like, you can enable various bridges and other services with very little effort. All the components are wired to work together."

  261. msgstr ""

  262. 

  263. #: ../../../docs/faq.md:114

  264. msgid "All services run in Docker containers (most being officially provided by each component's developers), so we're not at the mercy of distro packaging."

  265. msgstr ""

  266. 

  267. #: ../../../docs/faq.md:116

  268. msgid "Why use this playbook and not just use the Docker image directly?"

  269. msgstr ""

  270. 

  271. #: ../../../docs/faq.md:118

  272. msgid "Reasons are similar to the reasons for not installing manually."

  273. msgstr ""

  274. 

  275. #: ../../../docs/faq.md:120

  276. msgid "Besides Synapse, you'd need other things — a Postgres database, likely the [Element](https://element.io) client, etc., etc."

  277. msgstr ""

  278. 

  279. #: ../../../docs/faq.md:122

  280. msgid "Using the playbook, you get all these components in a way that works well together out of the box."

  281. msgstr ""

  282. 

  283. #: ../../../docs/faq.md:124

  284. msgid "Occasionally I see some people are talking about \"MDAD\". What is it?"

  285. msgstr ""

  286. 

  287. #: ../../../docs/faq.md:126

  288. msgid "It is the acronym of us: **m**atrix-**d**ocker-**a**nsible-**d**eploy."

  289. msgstr ""

  290. 

  291. #: ../../../docs/faq.md:128

  292. msgid "What's different about this Ansible playbook compared to [EMnify/matrix-synapse-auto-deploy](https://github.com/EMnify/matrix-synapse-auto-deploy)?"

  293. msgstr ""

  294. 

  295. #: ../../../docs/faq.md:130

  296. msgid "This is similar to the [EMnify/matrix-synapse-auto-deploy](https://github.com/EMnify/matrix-synapse-auto-deploy) Ansible deployment, but:"

  297. msgstr ""

  298. 

  299. #: ../../../docs/faq.md:132

  300. msgid "this one is a complete Ansible playbook (instead of just a role), so it's **easier to run** — especially for folks not familiar with Ansible"

  301. msgstr ""

  302. 

  303. #: ../../../docs/faq.md:134

  304. msgid "this one installs and hooks together **a lot more Matrix-related services** for you (see above)"

  305. msgstr ""

  306. 

  307. #: ../../../docs/faq.md:136

  308. msgid "this one **can be executed more than once** without causing trouble"

  309. msgstr ""

  310. 

  311. #: ../../../docs/faq.md:138

  312. msgid "works on various distros: **CentOS** (7.0+), Debian-based distributions (**Debian** 10/Buster+, **Ubuntu** 18.04+), **Archlinux**"

  313. msgstr ""

  314. 

  315. #: ../../../docs/faq.md:140

  316. msgid "this one installs everything in a single directory (`/matrix` by default) and **doesn't \"contaminate\" your server** with files all over the place"

  317. msgstr ""

  318. 

  319. #: ../../../docs/faq.md:142

  320. msgid "this one **doesn't necessarily take over** ports 80 and 443. By default, it sets up [Traefik](https://doc.traefik.io/traefik/) for you there, but you can also [use your own webserver](configuring-playbook-own-webserver.md)"

  321. msgstr ""

  322. 

  323. #: ../../../docs/faq.md:144

  324. msgid "this one **runs everything in Docker containers**, so it's likely more predictable and less fragile (see [Docker images used by this playbook](container-images.md))"

  325. msgstr ""

  326. 

  327. #: ../../../docs/faq.md:146

  328. msgid "this one retrieves and automatically renews free [Let's Encrypt](https://letsencrypt.org/) **SSL certificates** for you"

  329. msgstr ""

  330. 

  331. #: ../../../docs/faq.md:148

  332. msgid "this one optionally can store the `media_store` content repository files on [Amazon S3](https://aws.amazon.com/s3/) (but defaults to storing files on the server's filesystem)"

  333. msgstr ""

  334. 

  335. #: ../../../docs/faq.md:150

  336. msgid "this one optionally **allows you to use an external PostgreSQL server** for Synapse's database (but defaults to running one in a container)"

  337. msgstr ""

  338. 

  339. #: ../../../docs/faq.md:152

  340. msgid "helps you **import data from a previous installation** (so you can migrate your manual virtualenv/Docker setup to a more managed one)"

  341. msgstr ""

  342. 

  343. #: ../../../docs/faq.md:154

  344. msgid "this one is actually **maintained**"

  345. msgstr ""

  346. 

  347. #: ../../../docs/faq.md:156

  348. msgid "Server-related"

  349. msgstr ""

  350. 

  351. #: ../../../docs/faq.md:158

  352. msgid "What kind of server do I need to install Matrix using this Ansible playbook?"

  353. msgstr ""

  354. 

  355. #: ../../../docs/faq.md:160

  356. msgid "We list our server requirements in [Prerequisites](prerequisites.md)."

  357. msgstr ""

  358. 

  359. #: ../../../docs/faq.md:162

  360. msgid "Why not run Matrix on Kubernetes?"

  361. msgstr ""

  362. 

  363. #: ../../../docs/faq.md:164

  364. msgid "There's no reason not to run Matrix on [Kubernetes](https://kubernetes.io/)."

  365. msgstr ""

  366. 

  367. #: ../../../docs/faq.md:166

  368. msgid "However, that's overly complicated for thousands of us who just want to run a single small (and sometimes not so small) Matrix server, either using \"cloud\" servers or even a [Raspberry Pi](https://www.raspberrypi.org/) at home."

  369. msgstr ""

  370. 

  371. #: ../../../docs/faq.md:168

  372. msgid "For us, a Kubernetes-based setup which requires a cluster of multiple computers and is more technically-involved is a no-go."

  373. msgstr ""

  374. 

  375. #: ../../../docs/faq.md:170

  376. msgid "There are others working on automating a Matrix-on-Kubernetes setup, such as this [Helm](https://helm.sh/) chart: https://github.com/dacruz21/matrix-chart."

  377. msgstr ""

  378. 

  379. #: ../../../docs/faq.md:172

  380. msgid "Why don't you use Podman instead of Docker?"

  381. msgstr ""

  382. 

  383. #: ../../../docs/faq.md:174

  384. msgid "We like the philosophy of a daemonless container runtime, but [Podman](https://podman.io) is just not ready for our use case yet."

  385. msgstr ""

  386. 

  387. #: ../../../docs/faq.md:176

  388. msgid "Learn more about our past experiences/attempts to give Podman a chance, by reading [this issue](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/520)."

  389. msgstr ""

  390. 

  391. #: ../../../docs/faq.md:178

  392. msgid "In short, `alias podman=docker` is a lie (for us)."

  393. msgstr ""

  394. 

  395. #: ../../../docs/faq.md:180

  396. msgid "Why use Docker?"

  397. msgstr ""

  398. 

  399. #: ../../../docs/faq.md:182

  400. msgid "[Docker](https://www.docker.com/) is one of our 2 hard dependencies (the other one being [systemd](https://systemd.io/))."

  401. msgstr ""

  402. 

  403. #: ../../../docs/faq.md:184

  404. msgid "It lets us run services in an isolated manner and independently of the (usually old) packages available for distributions."

  405. msgstr ""

  406. 

  407. #: ../../../docs/faq.md:186

  408. msgid "It also lets us have a unified setup which runs the same across various supported distros (see them on [Prerequisites](prerequisites.md))."

  409. msgstr ""

  410. 

  411. #: ../../../docs/faq.md:188

  412. msgid "Is Docker a hard requirement?"

  413. msgstr ""

  414. 

  415. #: ../../../docs/faq.md:190

  416. msgid "Yes. See [Why don't you use Podman instead of Docker?](#why-dont-you-use-podman-instead-of-docker) for why we're not using another container runtime."

  417. msgstr ""

  418. 

  419. #: ../../../docs/faq.md:192

  420. msgid "All of our services run in containers. It's how we achieve predictability and also how we support tens of different services across lots of distros."

  421. msgstr ""

  422. 

  423. #: ../../../docs/faq.md:194

  424. msgid "The only thing we need on the distro is systemd and Python (we install Docker ourselves, unless you ask us not to)."

  425. msgstr ""

  426. 

  427. #: ../../../docs/faq.md:196

  428. msgid "Why don't you use docker-compose?"

  429. msgstr ""

  430. 

  431. #: ../../../docs/faq.md:198

  432. msgid "Instead of using [docker-compose](https://docs.docker.com/compose/), we prefer installing systemd services and scheduling those independently."

  433. msgstr ""

  434. 

  435. #: ../../../docs/faq.md:200

  436. msgid "There are people who have worked on turning this setup into a docker-compose-based one. See these experiments [here](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/64#issuecomment-603164625). There is also a demo project ([element-docker-demo](https://github.com/element-hq/element-docker-demo)) by Element."

  437. msgstr ""

  438. 

  439. #: ../../../docs/faq.md:202

  440. msgid "Can I run this on a distro without systemd?"

  441. msgstr ""

  442. 

  443. #: ../../../docs/faq.md:204

  444. msgid "No. [systemd](https://systemd.io/) is one of our 2 hard dependencies (the other one being [Docker](https://www.docker.com/))."

  445. msgstr ""

  446. 

  447. #: ../../../docs/faq.md:206

  448. msgid "Can I install this on a Raspberry Pi?"

  449. msgstr ""

  450. 

  451. #: ../../../docs/faq.md:208

  452. msgid "Yes, you can. See our [Alternative Architectures](alternative-architectures.md) documentation page."

  453. msgstr ""

  454. 

  455. #: ../../../docs/faq.md:210

  456. msgid "Whether a Raspberry Pi has enough power to give you a good experience is another question. It depends on your use case."

  457. msgstr ""

  458. 

  459. #: ../../../docs/faq.md:212

  460. msgid "Also see: [What kind of server specs do I need?](#what-kind-of-server-specs-do-i-need)."

  461. msgstr ""

  462. 

  463. #: ../../../docs/faq.md:214

  464. msgid "What kind of server specs do I need?"

  465. msgstr ""

  466. 

  467. #: ../../../docs/faq.md:216

  468. msgid "This largely depends on your use case. It's not so much the number of users that you plan to host, but rather the number of large rooms they will join."

  469. msgstr ""

  470. 

  471. #: ../../../docs/faq.md:218

  472. msgid "Federated rooms with lots of history and containing hundreds of other servers are very heavy CPU-wise and memory-wise."

  473. msgstr ""

  474. 

  475. #: ../../../docs/faq.md:220

  476. msgid "You can probably use a 1 CPU + 1GB memory server to host hundreds of local users just fine, but as soon as one of them joins a federated room like `#matrix:matrix.org` (Matrix HQ) or some IRC-bridged room (say `##linux`), your server will get the need for a lot more power (at least 2GB RAM, etc)."

  477. msgstr ""

  478. 

  479. #: ../../../docs/faq.md:222

  480. msgid "Running Matrix on a server with 1GB of memory is possible (especially if you disable some not-so-important services). See [How do I optimize this setup for a low-power server?](#how-do-i-optimize-this-setup-for-a-low-power-server)."

  481. msgstr ""

  482. 

  483. #: ../../../docs/faq.md:224

  484. msgid "**We recommend starting with a server having at least 2GB of memory** and even then using it sparingly. If you know for sure you'll be joining various large rooms, etc., then going for 4GB of memory or more is a good idea."

  485. msgstr ""

  486. 

  487. #: ../../../docs/faq.md:226

  488. msgid "Besides the regular Matrix stuff, we also support things like video-conferencing using [Jitsi](configuring-playbook-jitsi.md) and other additional services which (when installed) may use up a lot of memory. Things do add up. Besides the Synapse Matrix server, Jitsi is especially notorious for consuming a lot of resources. If you plan on running Jitsi, we recommend a server with at least 2GB of memory (preferrably more). See our [Jitsi documentation page](configuring-playbook-jitsi.md) to learn how to optimize its memory/CPU usage."

  489. msgstr ""

  490. 

  491. #: ../../../docs/faq.md:228

  492. msgid "Can I run this in an LXC container?"

  493. msgstr ""

  494. 

  495. #: ../../../docs/faq.md:230

  496. msgid "If your distro runs within an [LXC container](https://linuxcontainers.org/), you may hit [this issue](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/703). It can be worked around, if absolutely necessary, but we suggest that you avoid running from within an LXC container."

  497. msgstr ""

  498. 

  499. #: ../../../docs/faq.md:232

  500. msgid "Configuration"

  501. msgstr ""

  502. 

  503. #: ../../../docs/faq.md:234

  504. msgid "Why install my server at matrix.example.com and not at the base domain?"

  505. msgstr ""

  506. 

  507. #: ../../../docs/faq.md:236

  508. msgid "It's the same with email servers. Your email address is likely `name@company.com`, not `name@mail.company.com`, even though it's `mail.company.com` that is really handling your data for `@company.com` email to work."

  509. msgstr ""

  510. 

  511. #: ../../../docs/faq.md:238

  512. msgid "Using a separate domain name is easier to manage (although it's a little hard to get right at first) and keeps your Matrix server isolated from your website (if you have one), from your email server (if you have one), etc. Therefore, this playbook sets up services on your Matrix server (`matrix.example.com`) by default."

  513. msgstr ""

  514. 

  515. #: ../../../docs/faq.md:240

  516. msgid "I don't control anything on the base domain and can't set up delegation to matrix.example.com. What do I do?"

  517. msgstr ""

  518. 

  519. #: ../../../docs/faq.md:242

  520. msgid "If you're not in control of your base domain (or the server handling it) at all, you can take a look at [How do I install on matrix.example.com without involving the base domain?](#how-do-i-install-on-matrixexamplecom-without-involving-the-base-domain)"

  521. msgstr ""

  522. 

  523. #: ../../../docs/faq.md:244

  524. msgid "I can't set up HTTPS on the base domain. How will I get Matrix federating?"

  525. msgstr ""

  526. 

  527. #: ../../../docs/faq.md:246

  528. msgid "If you really can't obtain an HTTPS certificate for your base domain, you can take a look at [How do I install on matrix.example.com without involving the base domain?](#how-do-i-install-on-matrixexamplecom-without-involving-the-base-domain)"

  529. msgstr ""

  530. 

  531. #: ../../../docs/faq.md:248

  532. msgid "How do I install on matrix.example.com without involving the base domain?"

  533. msgstr ""

  534. 

  535. #: ../../../docs/faq.md:250

  536. msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"

  537. msgstr ""

  538. 

  539. #: ../../../docs/faq.md:271

  540. msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"

  541. msgstr ""

  542. 

  543. #: ../../../docs/faq.md:278

  544. msgid "**Notes**:"

  545. msgstr ""

  546. 

  547. #: ../../../docs/faq.md:280

  548. msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"

  549. msgstr ""

  550. 

  551. #: ../../../docs/faq.md:282

  552. msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too."

  553. msgstr ""

  554. 

  555. #: ../../../docs/faq.md:284

  556. msgid "Without setting up [server delegation](howto-server-delegation.md) to `matrix.example.com`, your user IDs will be like `@alice:matrix.example.com`. This is equivalent to having an email address like `bob@mail.company.com`, instead of just `bob@company.com`."

  557. msgstr ""

  558. 

  559. #: ../../../docs/faq.md:286

  560. msgid "I don't use the base domain for anything. How am I supposed to set up Server Delegation for Matrix services?"

  561. msgstr ""

  562. 

  563. #: ../../../docs/faq.md:288

  564. msgid "If you don't use your base domain for anything, then it's hard for you to \"serve files over HTTPS\" on it — something we ask you to do for the [.well-known](configuring-well-known.md) setup (needed for [Server Delegation](howto-server-delegation.md))."

  565. msgstr ""

  566. 

  567. #: ../../../docs/faq.md:290

  568. msgid "Luckily, the playbook can set up your Matrix server (at `matrix.example.com`) to also handle traffic for the base domain (`example.com`)."

  569. msgstr ""

  570. 

  571. #: ../../../docs/faq.md:292

  572. msgid "See [Serving the base domain](configuring-playbook-base-domain-serving.md)."

  573. msgstr ""

  574. 

  575. #: ../../../docs/faq.md:294

  576. msgid "How do I optimize this setup for a low-power server?"

  577. msgstr ""

  578. 

  579. #: ../../../docs/faq.md:296

  580. msgid "You can disable some not-so-important services to save on memory."

  581. msgstr ""

  582. 

  583. #: ../../../docs/faq.md:318

  584. msgid "You can also consider implementing a restriction on room complexity, in order to prevent users from joining very heavy rooms:"

  585. msgstr ""

  586. 

  587. #: ../../../docs/faq.md:328

  588. msgid "If you've installed [Jitsi](configuring-playbook-jitsi.md) (not installed by default), there are additional optimizations listed on its documentation page that you can perform."

  589. msgstr ""

  590. 

  591. #: ../../../docs/faq.md:330

  592. msgid "I already have Docker on my server. Can you stop installing Docker via the playbook?"

  593. msgstr ""

  594. 

  595. #: ../../../docs/faq.md:332

  596. msgid "Yes, we can stop installing Docker ourselves. Just use this in your `vars.yml` file:"

  597. msgstr ""

  598. 

  599. #: ../../../docs/faq.md:338

  600. msgid "I run another webserver on the same server where I wish to install Matrix. What now?"

  601. msgstr ""

  602. 

  603. #: ../../../docs/faq.md:340

  604. msgid "By default, we install a webserver for you ([Traefik](https://doc.traefik.io/traefik/)), but you can also use [your own webserver](configuring-playbook-own-webserver.md)."

  605. msgstr ""

  606. 

  607. #: ../../../docs/faq.md:342

  608. msgid "How is the effective configuration determined?"

  609. msgstr ""

  610. 

  611. #: ../../../docs/faq.md:344

  612. msgid "Configuration variables are defined in multiple places in this playbook and are considered in this order:"

  613. msgstr ""

  614. 

  615. #: ../../../docs/faq.md:346

  616. msgid "there are defaults coming from each role's defaults file (`role/matrix*/defaults/main.yml`). These variable values aim to be good defaults for when the role is used standalone (outside of this collection of roles, also called playbook)."

  617. msgstr ""

  618. 

  619. #: ../../../docs/faq.md:348

  620. msgid "then, there are overrides in `group_vars/matrix_servers`, which aim to adjust these \"standalone role defaults\" to something which better fits the playbook in its entirety."

  621. msgstr ""

  622. 

  623. #: ../../../docs/faq.md:350

  624. msgid "finally, there's your `inventory/host_vars/matrix.example.com/vars.yml` file, which is the ultimate override"

  625. msgstr ""

  626. 

  627. #: ../../../docs/faq.md:352

  628. msgid "What configuration variables are available?"

  629. msgstr ""

  630. 

  631. #: ../../../docs/faq.md:354

  632. msgid "You can discover the variables you can override in each role (`roles/*/*/defaults/main.yml`)."

  633. msgstr ""

  634. 

  635. #: ../../../docs/faq.md:356

  636. msgid "As described in [How is the effective configuration determined?](#how-is-the-effective-configuration-determined), these role-defaults may be overriden by values defined in `group_vars/matrix_servers`."

  637. msgstr ""

  638. 

  639. #: ../../../docs/faq.md:358

  640. msgid "Refer to both of these for inspiration. Still, as mentioned in [Configuring the playbook](configuring-playbook.md), you're only ever supposed to edit your own `inventory/host_vars/matrix.example.com/vars.yml` file and nothing else inside the playbook (unless you're meaning to contribute new features)."

  641. msgstr ""

  642. 

  643. #: ../../../docs/faq.md:360 ../../../docs/faq.md:372

  644. msgid "**Note**: some of the roles (`roles/galaxy/*`) live in separate repositories and are only installed after your run `just roles` (or `make roles`) or `just update` (which automatically does `git pull` and `just roles`)."

  645. msgstr ""

  646. 

  647. #: ../../../docs/faq.md:362

  648. msgid "I'd like to adjust some configuration which doesn't have a corresponding variable. How do I do it?"

  649. msgstr ""

  650. 

  651. #: ../../../docs/faq.md:364

  652. msgid "The playbook doesn't aim to expose all configuration settings for all services using variables. Doing so would amount to hundreds of variables that we have to create and maintain."

  653. msgstr ""

  654. 

  655. #: ../../../docs/faq.md:366

  656. msgid "Instead, we only try to make some important basics configurable using dedicated variables you can see in each role. See [What configuration variables are available?](#what-configuration-variables-are-available)."

  657. msgstr ""

  658. 

  659. #: ../../../docs/faq.md:368

  660. msgid "Besides that, each role (component) aims to provide a `matrix_SOME_COMPONENT_configuration_extension_yaml` (or `matrix_SOME_COMPONENT_configuration_extension_json`) variable, which can be used to override the configuration."

  661. msgstr ""

  662. 

  663. #: ../../../docs/faq.md:370

  664. msgid "Check each role's `roles/*/*/defaults/main.yml` for the corresponding variable and an example for how use it."

  665. msgstr ""

  666. 

  667. #: ../../../docs/faq.md:374

  668. msgid "Installation"

  669. msgstr ""

  670. 

  671. #: ../../../docs/faq.md:376

  672. msgid "How do I run the installation?"

  673. msgstr ""

  674. 

  675. #: ../../../docs/faq.md:378

  676. msgid "See [Installing](installing.md) to learn how to use Ansible to install Matrix services."

  677. msgstr ""

  678. 

  679. #: ../../../docs/faq.md:380

  680. msgid "However, we recommend you to follow our installation guide, instead of jumping straight to installing."

  681. msgstr ""

  682. 

  683. #: ../../../docs/faq.md:382

  684. msgid "There are two guides available:"

  685. msgstr ""

  686. 

  687. #: ../../../docs/faq.md:384

  688. msgid "⚡ **[Quick start](quick-start.md)** (for beginners): this is recommended for those who do not have an existing Matrix server and want to start quickly with \"opinionated defaults\"."

  689. msgstr ""

  690. 

  691. #: ../../../docs/faq.md:386

  692. msgid "**Full installation guide (for advanced users)**: if you need to import an existing Matrix server's data into the new server or want to learn more while setting up the server, follow this guide by starting with the **[Prerequisites](prerequisites.md)** documentation page."

  693. msgstr ""

  694. 

  695. #: ../../../docs/faq.md:388

  696. msgid "I installed Synapse some other way. Can I migrate such a setup to the playbook?"

  697. msgstr ""

  698. 

  699. #: ../../../docs/faq.md:390

  700. msgid "Yes, you can."

  701. msgstr ""

  702. 

  703. #: ../../../docs/faq.md:392

  704. msgid "You generally need to do a playbook installation. It's recommended to follow the full installation guide (starting at the [Prerequisites](prerequisites.md) page), not the [Quick start](quick-start.md) guide. The full installation guide will tell you when it's time to import your existing data into the newly-prepared server."

  705. msgstr ""

  706. 

  707. #: ../../../docs/faq.md:394

  708. msgid "This Ansible playbook guides you into installing a server for `example.com` (user IDs are like this: `@alice:example.com`), while the server is at `matrix.example.com`. If your existing setup has a server name (`server_name` configuration setting in Synapse's `homeserver.yaml` file) other than the base `example.com`, you may need to tweak some additional variables. This FAQ entry may be of use if you're dealing with a more complicated setup — [How do I install on matrix.example.com without involving the base domain?](#how-do-i-install-on-matrixexamplecom-without-involving-the-base-domain)"

  709. msgstr ""

  710. 

  711. #: ../../../docs/faq.md:396

  712. msgid "After configuring the playbook and installing and **before starting** services (done with `ansible-playbook … --tags=start`) you'd import [your SQLite](importing-synapse-sqlite.md) (or [Postgres](importing-postgres.md)) database and also [import your media store](importing-synapse-media-store.md)."

  713. msgstr ""

  714. 

  715. #: ../../../docs/faq.md:398

  716. msgid "I've downloaded Ansible and the playbook on the server. It can't connect using SSH."

  717. msgstr ""

  718. 

  719. #: ../../../docs/faq.md:400

  720. msgid "If you're using the playbook directly on the server, then Ansible doesn't need to connect using SSH."

  721. msgstr ""

  722. 

  723. #: ../../../docs/faq.md:402

  724. msgid "It can perform a local connection instead. Just set `ansible_connection=local` at the end of the server line in `inventory/hosts` and re-run the playbook."

  725. msgstr ""

  726. 

  727. #: ../../../docs/faq.md:404

  728. msgid "If you're running Ansible from within a container (one of the possibilities we list on our [dedicated Ansible documentation page](ansible.md)), then using `ansible_connection=local` is not possible."

  729. msgstr ""

  730. 

  731. #: ../../../docs/faq.md:406

  732. msgid "Troubleshooting"

  733. msgstr ""

  734. 

  735. #: ../../../docs/faq.md:408

  736. msgid "I get \"Error response from daemon: configured logging driver does not support reading\" when I do `docker logs matrix-synapse`."

  737. msgstr ""

  738. 

  739. #: ../../../docs/faq.md:410

  740. msgid "See [How can I see the logs?](#how-can-i-see-the-logs)."

  741. msgstr ""

  742. 

  743. #: ../../../docs/faq.md:412

  744. msgid "How can I see the logs?"

  745. msgstr ""

  746. 

  747. #: ../../../docs/faq.md:414

  748. msgid "We utilize [systemd/journald](https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html#Description) for logging."

  749. msgstr ""

  750. 

  751. #: ../../../docs/faq.md:416

  752. msgid "To see logs for Synapse, run `journalctl -fu matrix-synapse.service`. You may wish to see the [manual page for journalctl](https://www.commandlinux.com/man-page/man1/journalctl.1.html)."

  753. msgstr ""

  754. 

  755. #: ../../../docs/faq.md:418

  756. msgid "Available service names can be seen by doing `ls /etc/systemd/system/matrix*.service` on the server."

  757. msgstr ""

  758. 

  759. #: ../../../docs/faq.md:420

  760. msgid "Some services also log to files in `/matrix/*/data/..`, but we're slowly moving away from that."

  761. msgstr ""

  762. 

  763. #: ../../../docs/faq.md:422

  764. msgid "We also disable Docker logging, so you can't use `docker logs matrix-*` either. We do this to prevent useless double (or even triple) logging and to avoid having to rotate log files."

  765. msgstr ""

  766. 

  767. #: ../../../docs/faq.md:424

  768. msgid "We just simply delegate logging to journald and it takes care of persistence and expiring old data."

  769. msgstr ""

  770. 

  771. #: ../../../docs/faq.md:426

  772. msgid "Also see: [How long do systemd/journald logs persist for?](#how-long-do-systemdjournald-logs-persist-for)"

  773. msgstr ""

  774. 

  775. #: ../../../docs/faq.md:428

  776. msgid "How long do systemd/journald logs persist for?"

  777. msgstr ""

  778. 

  779. #: ../../../docs/faq.md:430

  780. msgid "On some distros, the journald logs are just in-memory and not persisted to disk."

  781. msgstr ""

  782. 

  783. #: ../../../docs/faq.md:432

  784. msgid "Consult (and feel free to adjust) your distro's journald logging configuration in `/etc/systemd/journald.conf`."

  785. msgstr ""

  786. 

  787. #: ../../../docs/faq.md:434

  788. msgid "To enable persistence and put some limits on how large the journal log files can become, adjust your configuration like this:"

  789. msgstr ""

  790. 

  791. #: ../../../docs/faq.md:445

  792. msgid "Maintenance"

  793. msgstr ""

  794. 

  795. #: ../../../docs/faq.md:447

  796. msgid "Do I need to do anything to keep my Matrix server updated?"

  797. msgstr ""

  798. 

  799. #: ../../../docs/faq.md:449

  800. msgid "Yes. We don't update anything for you automatically."

  801. msgstr ""

  802. 

  803. #: ../../../docs/faq.md:451

  804. msgid "See our [documentation page about upgrading services](maintenance-upgrading-services.md)."

  805. msgstr ""

  806. 

  807. #: ../../../docs/faq.md:453

  808. msgid "How do I move my existing installation to another (VM) server?"

  809. msgstr ""

  810. 

  811. #: ../../../docs/faq.md:455

  812. msgid "If you have an existing installation done using this Ansible playbook, you can easily migrate that to another server using [our dedicated server migration guide](maintenance-migrating.md)."

  813. msgstr ""

  814. 

  815. #: ../../../docs/faq.md:457

  816. msgid "If your previous installation is done in some other way (not using this Ansible playbook), see [I installed Synapse some other way. Can I migrate such a setup to the playbook?](#i-installed-synapse-some-other-way-can-i-migrate-such-a-setup-to-the-playbook)."

  817. msgstr ""

  818. 

  819. #: ../../../docs/faq.md:459

  820. msgid "How do I back up the data on my server?"

  821. msgstr ""

  822. 

  823. #: ../../../docs/faq.md:461

  824. msgid "We haven't documented this properly yet, but the general advice is to:"

  825. msgstr ""

  826. 

  827. #: ../../../docs/faq.md:463

  828. msgid "back up Postgres by making a database dump. See [Backing up PostgreSQL](maintenance-postgres.md#backing-up-postgresql)"

  829. msgstr ""

  830. 

  831. #: ../../../docs/faq.md:465

  832. msgid "back up all `/matrix` files, except for `/matrix/postgres/data` (you already have a dump) and `/matrix/postgres/data-auto-upgrade-backup` (this directory may exist and contain your old data if you've [performed a major Postgres upgrade](maintenance-postgres.md#upgrading-postgresql))."

  833. msgstr ""

  834. 

  835. #: ../../../docs/faq.md:467

  836. msgid "You can later restore these by:"

  837. msgstr ""

  838. 

  839. #: ../../../docs/faq.md:469

  840. msgid "Restoring the `/matrix` directory and files on the new server manually"

  841. msgstr ""

  842. 

  843. #: ../../../docs/faq.md:470

  844. msgid "Following the instruction described on [Installing a server into which you'll import old data](installing.md#installing-a-server-into-which-youll-import-old-data)"

  845. msgstr ""

  846. 

  847. #: ../../../docs/faq.md:472

  848. msgid "If your server's IP address has changed, you may need to [set up DNS](configuring-dns.md) again."

  849. msgstr ""

  850. 

  851. #: ../../../docs/faq.md:474

  852. msgid "What is this `/matrix/postgres/data-auto-upgrade-backup` directory that is taking up so much space?"

  853. msgstr ""

  854. 

  855. #: ../../../docs/faq.md:476

  856. msgid "When you [perform a major Postgres upgrade](maintenance-postgres.md#upgrading-postgresql), we save the the old data files in `/matrix/postgres/data-auto-upgrade-backup`, just so you could easily restore them should something have gone wrong."

  857. msgstr ""

  858. 

  859. #: ../../../docs/faq.md:478

  860. msgid "After verifying that everything still works after the Postgres upgrade, you can safely delete `/matrix/postgres/data-auto-upgrade-backup`"

  861. msgstr ""

  862. 

  863. #: ../../../docs/faq.md:480

  864. msgid "How do I debug or force SSL certificate renewal?"

  865. msgstr ""

  866. 

  867. #: ../../../docs/faq.md:482

  868. msgid "SSL certificates are managed automatically by the [Traefik](https://doc.traefik.io/traefik/) reverse-proxy server."

  869. msgstr ""

  870. 

  871. #: ../../../docs/faq.md:484

  872. msgid "If you're having trouble with SSL certificate renewal, check the Traefik logs (`journalctl -fu matrix-traefik`)."

  873. msgstr ""

  874. 

  875. #: ../../../docs/faq.md:486

  876. msgid "If you're [using your own webserver](configuring-playbook-own-webserver.md) instead of the integrated one (Traefik), you should investigate in another way."

  877. msgstr ""

  878. 

  879. #: ../../../docs/faq.md:488

  880. msgid "Miscellaneous"

  881. msgstr ""

  882. 

  883. #: ../../../docs/faq.md:490

  884. msgid "I would like to see this favorite service of mine integrated and become available on my Matrix server. How can I request it?"

  885. msgstr ""

  886. 

  887. #: ../../../docs/faq.md:492

  888. msgid "You can freely create an issue for feature request on the repository at GitHub [here](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/new). Note this is a community project with no financial backing, and there is not assurance that your request would be eventually picked up by others and the requested feature would become available. The easiest way to get a feature into this project is to just develop it yourself."

  889. msgstr ""

  890. 

  891. #: ../../../docs/faq.md:494

  892. msgid "Also, please note that this playbook intends to focus solely on Matrix and Matrix-related services. If your request is not specific to Matrix, you may as well to consider to submit it to the [mash-playbook](https://github.com/mother-of-all-self-hosting/mash-playbook), maintained by the members behind this matrix-docker-ansible-deploy project. [This document on the interoperability](https://github.com/mother-of-all-self-hosting/mash-playbook/blob/main/docs/interoperability.md) describes how to deploy services along with the Matrix services easily."

  893. msgstr ""