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.
 
 

1355 lines
41 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/faq.md:1
  23. msgid "Frequently Asked Questions"
  24. msgstr ""
  25. #: ../../../docs/faq.md:3
  26. msgid ""
  27. "This documentation page tries to answer various Frequently Asked "
  28. "Questions about all things [Matrix](https://matrix.org/), with a focus on"
  29. " this [Ansible](https://www.ansible.com/) playbook ([What is Ansible? How"
  30. " does it work?](#what-is-ansible-how-does-it-work))."
  31. msgstr ""
  32. #: ../../../docs/faq.md:5
  33. msgid ""
  34. "This FAQ page does not intend to replace the [matrix.org "
  35. "FAQ](https://matrix.org/faq/) (please see that one too)."
  36. msgstr ""
  37. #: ../../../docs/faq.md:7
  38. msgid "We've only started this FAQ recently, so it's still somewhat empty."
  39. msgstr ""
  40. #: ../../../docs/faq.md:9
  41. msgid ""
  42. "Also, we encourage you to not dig yourself into a hole by reading way too"
  43. " much. When you've heard enough, proceed to installation. To get started,"
  44. " see [below](#how-do-i-run-the-installation) about our installation "
  45. "guides."
  46. msgstr ""
  47. #: ../../../docs/faq.md:11
  48. msgid "Introductory"
  49. msgstr ""
  50. #: ../../../docs/faq.md:13
  51. msgid "Where do I find more questions and answers about Matrix?"
  52. msgstr ""
  53. #: ../../../docs/faq.md:15
  54. msgid ""
  55. "This is a Frequently Asked Questions page focused on this "
  56. "[Ansible](https://www.ansible.com/) playbook ([What is Ansible? How does "
  57. "it work?](#what-is-ansible-how-does-it-work)) for deploying a "
  58. "[Matrix](https://matrix.org/) server."
  59. msgstr ""
  60. #: ../../../docs/faq.md:17
  61. msgid ""
  62. "For a lot more generic questions and answers, see the [matrix.org "
  63. "FAQ](https://matrix.org/faq/)."
  64. msgstr ""
  65. #: ../../../docs/faq.md:19
  66. msgid ""
  67. "What is Matrix? What is Element? What is Synapse? Why are you confusing "
  68. "me with so many terms?"
  69. msgstr ""
  70. #: ../../../docs/faq.md:21
  71. msgid ""
  72. "[Matrix](https://matrix.org/) is a new type of realtime communication "
  73. "(chat) network, the closest analogy to which is probably \"email\"."
  74. msgstr ""
  75. #: ../../../docs/faq.md:23
  76. msgid ""
  77. "You don't just use the \"email\" protocols (SMTP, POP3, IMAP) directly "
  78. "though. There's a *server* somewhere which stores your data "
  79. "(`@gmail.com`, `@yahoo.com`, `@hotmail.com`, `@your-company.com`) and you"
  80. " access it by using these \"email\" protocols via some *client* program "
  81. "(Outlook, Thunderbird, some website, etc)."
  82. msgstr ""
  83. #: ../../../docs/faq.md:25
  84. msgid ""
  85. "In the world of the Matrix chat protocol, there are various client "
  86. "programs. The first and currently most full-featured one is called "
  87. "[Element](https://element.io/) (used to be called Riot.im and Vector.im "
  88. "in the past). There are [many other "
  89. "clients](https://matrix.org/clients/). You can switch clients as much as "
  90. "you want until you find the one that is right for you on a given platform"
  91. " (you may use Element Desktop on your desktop, but Fluffychat on your "
  92. "phone, etc)."
  93. msgstr ""
  94. #: ../../../docs/faq.md:27
  95. msgid ""
  96. "Matrix is also like email due to the fact that there are many servers "
  97. "around the world which can all talk to each other (you can send email "
  98. "from `@gmail.com` addresses to `@yahoo.com` and `@hotmail.com` "
  99. "addresses). It's the same with Matrix (`@bob:example.com` can talk to "
  100. "`@alice:example.org`)."
  101. msgstr ""
  102. #: ../../../docs/faq.md:29
  103. msgid ""
  104. "If someone else is hosting your Matrix server (you being "
  105. "`@alice:matrix.org` or some other public server like this), all you need "
  106. "is a Matrix client program, like Element Web or Element X Android."
  107. msgstr ""
  108. #: ../../../docs/faq.md:31
  109. msgid ""
  110. "If you'd like to host your own server (you being `@alice:example.com`), "
  111. "you'd need to set up a Matrix server program, like Synapse."
  112. msgstr ""
  113. #: ../../../docs/faq.md:33
  114. msgid "In short:"
  115. msgstr ""
  116. #: ../../../docs/faq.md:35
  117. msgid ""
  118. "Matrix is the protocol - a set of rules about how the chat network "
  119. "operates"
  120. msgstr ""
  121. #: ../../../docs/faq.md:36
  122. msgid ""
  123. "Element is a client program you can use to participate on the Matrix chat"
  124. " network via some server (yours or someone else's). There are also [many "
  125. "other client programs](https://matrix.org/clients/)."
  126. msgstr ""
  127. #: ../../../docs/faq.md:37
  128. msgid ""
  129. "Synapse is a server program you can use to host your very own Matrix "
  130. "server."
  131. msgstr ""
  132. #: ../../../docs/faq.md:39
  133. msgid ""
  134. "This FAQ here mostly focuses on installing various Matrix services using "
  135. "the Ansible automation tool. You can learn much more about Matrix in the "
  136. "[matrix.org FAQ](https://matrix.org/faq/)."
  137. msgstr ""
  138. #: ../../../docs/faq.md:41
  139. msgid "People I wish to talk to are not on Matrix. Can I talk to them?"
  140. msgstr ""
  141. #: ../../../docs/faq.md:43
  142. msgid ""
  143. "You most likely can. Besides Matrix-native chats, Matrix also supports "
  144. "the concept of \"bridging\", which allows you to plug other networks into"
  145. " it."
  146. msgstr ""
  147. #: ../../../docs/faq.md:45
  148. msgid ""
  149. "This Ansible playbook can help you install [tens of bridges for various "
  150. "networks](configuring-playbook.md#bridging-other-networks)."
  151. msgstr ""
  152. #: ../../../docs/faq.md:47
  153. msgid ""
  154. "Besides setting up your own bridges (preferable), you can also use some "
  155. "[public bridges hosted by others](https://publiclist.anchel.nl/#bridges)."
  156. msgstr ""
  157. #: ../../../docs/faq.md:49
  158. msgid "How do I get started with Matrix?"
  159. msgstr ""
  160. #: ../../../docs/faq.md:51
  161. msgid ""
  162. "One of [Matrix](https://matrix.org/)'s distinguishing strengths (compared"
  163. " to other chat networks) is its decentralized nature. There's not just "
  164. "one entity (company, organization) controlling the servers. Rather "
  165. "there's thousands of servers operated by different people - one server "
  166. "being insecure, slow or disrespective toward its users does not affect "
  167. "the rest of the network. To participate in that decentralization in its "
  168. "fullest, consider hosting your own server or using some public server "
  169. "other than the largest/default one (`matrix.org`)."
  170. msgstr ""
  171. #: ../../../docs/faq.md:53
  172. msgid ""
  173. "There are 3 ways to get into Matrix, depending on your technical ability "
  174. "and needs:"
  175. msgstr ""
  176. #: ../../../docs/faq.md:55
  177. msgid ""
  178. "**using the existing default server** - the easiest way is to use an "
  179. "existing server. The largest public Matrix server is `matrix.org` and "
  180. "it's configured as a default server in clients such as [Element "
  181. "Web](https://app.element.io) and many others. Just use Element Web on the"
  182. " browser via that link (or [download client apps for your Desktop or "
  183. "smartphone](https://element.io/app-for-productivity)), create an account "
  184. "and start chatting."
  185. msgstr ""
  186. #: ../../../docs/faq.md:57
  187. msgid ""
  188. "**using some other server** - instead of using the largest public server "
  189. "(`matrix.org`), you can use another public one. Here's a [list of public "
  190. "Matrix servers](https://joinmatrix.org/servers/) to choose from. Go to "
  191. "[Element Web](https://app.element.io) or download [some other "
  192. "client](https://matrix.org/clients/) of your choosing and adjust the "
  193. "homeserver URL during login."
  194. msgstr ""
  195. #: ../../../docs/faq.md:59
  196. msgid ""
  197. "**using your own server** - running your own server puts you in ultimate "
  198. "control of your data. It also lets you have your own user IDs (e.g. "
  199. "`@bob:example.com`). See [How do I set up my own Matrix server](#how-do-i"
  200. "-set-up-my-own-matrix-server)."
  201. msgstr ""
  202. #: ../../../docs/faq.md:61
  203. msgid "How do I set up my own Matrix server?"
  204. msgstr ""
  205. #: ../../../docs/faq.md:63
  206. msgid ""
  207. "Normally, you'd first choose the [Matrix](https://matrix.org/) server "
  208. "software you'd like to run. At the time of this writing (January/2021), "
  209. "there's only one fully-featured server program, so there's only one "
  210. "reasonable choice. That's [Synapse](https://github.com/element-"
  211. "hq/synapse)."
  212. msgstr ""
  213. #: ../../../docs/faq.md:65
  214. msgid ""
  215. "There are [many guides about installing "
  216. "Synapse](https://matrix.org/docs/guides/#installing-synapse). Using this "
  217. "Ansible playbook is just one way of doing it."
  218. msgstr ""
  219. #: ../../../docs/faq.md:67
  220. msgid ""
  221. "Naturally, we're biased, so our usual recommendation is to go with this "
  222. "[Ansible](https://www.ansible.com/) playbook, instead of installing "
  223. "Synapse (and many many other things around it) manually."
  224. msgstr ""
  225. #: ../../../docs/faq.md:69
  226. msgid ""
  227. "To get started with the playbook, check out the [Quick start](quick-"
  228. "start.md) or full installation guide (starting at the "
  229. "[Prerequisites](prerequisites.md) page)."
  230. msgstr ""
  231. #: ../../../docs/faq.md:71
  232. msgid "What is Ansible? How does it work?"
  233. msgstr ""
  234. #: ../../../docs/faq.md:73
  235. msgid ""
  236. "[Ansible](https://www.ansible.com/) is an automation program. This "
  237. "\"playbook\" is a collection of tasks/scripts that will set up a "
  238. "[Matrix](https://matrix.org/) server for you, so you don't have to "
  239. "perform these tasks manually."
  240. msgstr ""
  241. #: ../../../docs/faq.md:75
  242. msgid ""
  243. "We have written these automated tasks for you and all you need to do is "
  244. "execute them using the Ansible program."
  245. msgstr ""
  246. #: ../../../docs/faq.md:77
  247. msgid ""
  248. "You can install Ansible and this playbook code repository on your own "
  249. "computer and tell it to install Matrix services at the server living at "
  250. "`matrix.example.com`. We recommend installing Ansible on your own "
  251. "computer."
  252. msgstr ""
  253. #: ../../../docs/faq.md:79
  254. msgid ""
  255. "Alternatively, you can download Ansible and the playbook itself directly "
  256. "on the `matrix.example.com` server."
  257. msgstr ""
  258. #: ../../../docs/faq.md:81
  259. msgid "To learn more, see our [dedicated Ansible documentation page](ansible.md)."
  260. msgstr ""
  261. #: ../../../docs/faq.md:83
  262. msgid "What is `just`?"
  263. msgstr ""
  264. #: ../../../docs/faq.md:85
  265. msgid ""
  266. "[`just`](https://github.com/casey/just) is a modern command-runner "
  267. "alternative to [make](https://www.gnu.org/software/make/). It can be used"
  268. " to invoke commands with less typing."
  269. msgstr ""
  270. #: ../../../docs/faq.md:87
  271. msgid ""
  272. "The `just` utility executes shortcut commands (called \"recipes\"), which"
  273. " invoke `ansible-playbook`, `ansible-galaxy` or "
  274. "[`agru`](https://github.com/etkecc/agru) (depending on what is available "
  275. "in your system). The targets of the recipes are defined in "
  276. "[`justfile`](../justfile)."
  277. msgstr ""
  278. #: ../../../docs/faq.md:89
  279. msgid ""
  280. "For details about `just` commands, take a look at: [Running `just` "
  281. "commands](just.md)."
  282. msgstr ""
  283. #: ../../../docs/faq.md:91
  284. msgid ""
  285. "The playbook also contains a `Makefile` for the `make` tool, but most of "
  286. "the just recipes are not available as targets in the `Makefile`."
  287. msgstr ""
  288. #: ../../../docs/faq.md:93
  289. msgid "Why use this playbook and not install Synapse and other things manually?"
  290. msgstr ""
  291. #: ../../../docs/faq.md:95
  292. msgid ""
  293. "There are various guides telling you how easy it is to install "
  294. "[Synapse](https://github.com/element-hq/synapse)."
  295. msgstr ""
  296. #: ../../../docs/faq.md:97
  297. msgid ""
  298. "Reading the documentation of this Ansible playbook, you may also be "
  299. "thinking:"
  300. msgstr ""
  301. #: ../../../docs/faq.md:99
  302. msgid ""
  303. "I don't know what [Ansible](https://www.ansible.com/) is. I don't know "
  304. "what [Docker](https://www.docker.com/) is. This looks more complicated."
  305. msgstr ""
  306. #: ../../../docs/faq.md:101
  307. msgid ""
  308. ".. so you may be leaning toward [installing Synapse "
  309. "manually](https://github.com/element-hq/synapse/blob/master/INSTALL.md)."
  310. msgstr ""
  311. #: ../../../docs/faq.md:103
  312. msgid "The problem with a manual installation is:"
  313. msgstr ""
  314. #: ../../../docs/faq.md:105
  315. msgid ""
  316. "Synapse is written in Python. If not packaged for your distribution, "
  317. "you'd need to install various Python modules, etc., and keep them "
  318. "updated."
  319. msgstr ""
  320. #: ../../../docs/faq.md:106
  321. msgid ""
  322. "Synapse requires a [Postgres](https://www.postgresql.org/) database (it "
  323. "can run on SQLite, but that's very much discouraged). So you'd need to "
  324. "install Postgres as well."
  325. msgstr ""
  326. #: ../../../docs/faq.md:107
  327. msgid ""
  328. "you may also need a reverse-proxy server in front of it (nginx, Apache), "
  329. "so you'd need to be familiar with that"
  330. msgstr ""
  331. #: ../../../docs/faq.md:108
  332. msgid ""
  333. "SSL is required, so you'd need to obtain Let's Encrypt (or other free or "
  334. "non-free) certificates for one or more domain names. You'd need to be "
  335. "familiar with [certbot](https://certbot.eff.org/) (when using Let's "
  336. "Encrypt) or similar software."
  337. msgstr ""
  338. #: ../../../docs/faq.md:109
  339. msgid ""
  340. "for each additional component you'd like to add (client like "
  341. "[Element](https://element.io), bridge to some other chat network, "
  342. "integration manager (stickers, other services, Identity Manager, etc.), "
  343. "you'll need to spend extra time installing and wiring it with the rest of"
  344. " the system in a way that works."
  345. msgstr ""
  346. #: ../../../docs/faq.md:110
  347. msgid ""
  348. "you'll likely get slower updates for all of these components, depending "
  349. "on your distro packaging or your own time and ability"
  350. msgstr ""
  351. #: ../../../docs/faq.md:112
  352. msgid ""
  353. "The playbook, on the other hand, installs a bunch of components for you "
  354. "by default, obtains SSL certificates for you, etc. If you'd like, you can"
  355. " enable various bridges and other services with very little effort. All "
  356. "the components are wired to work together."
  357. msgstr ""
  358. #: ../../../docs/faq.md:114
  359. msgid ""
  360. "All services run in Docker containers (most being officially provided by "
  361. "each component's developers), so we're not at the mercy of distro "
  362. "packaging."
  363. msgstr ""
  364. #: ../../../docs/faq.md:116
  365. msgid "Why use this playbook and not just use the Docker image directly?"
  366. msgstr ""
  367. #: ../../../docs/faq.md:118
  368. msgid "Reasons are similar to the reasons for not installing manually."
  369. msgstr ""
  370. #: ../../../docs/faq.md:120
  371. msgid ""
  372. "Besides Synapse, you'd need other things - a Postgres database, likely "
  373. "the [Element](https://element.io) client, etc., etc."
  374. msgstr ""
  375. #: ../../../docs/faq.md:122
  376. msgid ""
  377. "Using the playbook, you get all these components in a way that works well"
  378. " together out of the box."
  379. msgstr ""
  380. #: ../../../docs/faq.md:124
  381. msgid "Occasionally I see some people are talking about \"MDAD\". What is it?"
  382. msgstr ""
  383. #: ../../../docs/faq.md:126
  384. msgid "It is the acronym of us: **m**atrix-**d**ocker-**a**nsible-**d**eploy."
  385. msgstr ""
  386. #: ../../../docs/faq.md:128
  387. msgid ""
  388. "What's different about this Ansible playbook compared to [EMnify/matrix-"
  389. "synapse-auto-deploy](https://github.com/EMnify/matrix-synapse-auto-"
  390. "deploy)?"
  391. msgstr ""
  392. #: ../../../docs/faq.md:130
  393. msgid ""
  394. "This is similar to the [EMnify/matrix-synapse-auto-"
  395. "deploy](https://github.com/EMnify/matrix-synapse-auto-deploy) Ansible "
  396. "deployment, but:"
  397. msgstr ""
  398. #: ../../../docs/faq.md:132
  399. msgid ""
  400. "this one is a complete Ansible playbook (instead of just a role), so it's"
  401. " **easier to run** - especially for folks not familiar with Ansible"
  402. msgstr ""
  403. #: ../../../docs/faq.md:134
  404. msgid ""
  405. "this one installs and hooks together **a lot more Matrix-related "
  406. "services** for you (see above)"
  407. msgstr ""
  408. #: ../../../docs/faq.md:136
  409. msgid "this one **can be executed more than once** without causing trouble"
  410. msgstr ""
  411. #: ../../../docs/faq.md:138
  412. msgid ""
  413. "works on various distros: **CentOS** (7.0+), Debian-based distributions "
  414. "(**Debian** 10/Buster+, **Ubuntu** 18.04+), **Archlinux**"
  415. msgstr ""
  416. #: ../../../docs/faq.md:140
  417. msgid ""
  418. "this one installs everything in a single directory (`/matrix` by default)"
  419. " and **doesn't \"contaminate\" your server** with files all over the "
  420. "place"
  421. msgstr ""
  422. #: ../../../docs/faq.md:142
  423. msgid ""
  424. "this one **doesn't necessarily take over** ports 80 and 443. By default, "
  425. "it sets up [Traefik](https://doc.traefik.io/traefik/) for you there, but "
  426. "you can also [use your own webserver](configuring-playbook-own-"
  427. "webserver.md)"
  428. msgstr ""
  429. #: ../../../docs/faq.md:144
  430. msgid ""
  431. "this one **runs everything in Docker containers**, so it's likely more "
  432. "predictable and less fragile (see [Docker images used by this playbook"
  433. "](container-images.md))"
  434. msgstr ""
  435. #: ../../../docs/faq.md:146
  436. msgid ""
  437. "this one retrieves and automatically renews free [Let's "
  438. "Encrypt](https://letsencrypt.org/) **SSL certificates** for you"
  439. msgstr ""
  440. #: ../../../docs/faq.md:148
  441. msgid ""
  442. "this one optionally can store the `media_store` content repository files "
  443. "on [Amazon S3](https://aws.amazon.com/s3/) (but defaults to storing files"
  444. " on the server's filesystem)"
  445. msgstr ""
  446. #: ../../../docs/faq.md:150
  447. msgid ""
  448. "this one optionally **allows you to use an external PostgreSQL server** "
  449. "for Synapse's database (but defaults to running one in a container)"
  450. msgstr ""
  451. #: ../../../docs/faq.md:152
  452. msgid ""
  453. "helps you **import data from a previous installation** (so you can "
  454. "migrate your manual virtualenv/Docker setup to a more managed one)"
  455. msgstr ""
  456. #: ../../../docs/faq.md:154
  457. msgid "this one is actually **maintained**"
  458. msgstr ""
  459. #: ../../../docs/faq.md:156
  460. msgid "Server-related"
  461. msgstr ""
  462. #: ../../../docs/faq.md:158
  463. msgid ""
  464. "What kind of server do I need to install Matrix using this Ansible "
  465. "playbook?"
  466. msgstr ""
  467. #: ../../../docs/faq.md:160
  468. msgid "We list our server requirements in [Prerequisites](prerequisites.md)."
  469. msgstr ""
  470. #: ../../../docs/faq.md:162
  471. msgid "Why not run Matrix on Kubernetes?"
  472. msgstr ""
  473. #: ../../../docs/faq.md:164
  474. msgid ""
  475. "There's no reason not to run Matrix on "
  476. "[Kubernetes](https://kubernetes.io/)."
  477. msgstr ""
  478. #: ../../../docs/faq.md:166
  479. msgid ""
  480. "However, that's overly complicated for thousands of us who just want to "
  481. "run a single small (and sometimes not so small) Matrix server, either "
  482. "using \"cloud\" servers or even a [Raspberry "
  483. "Pi](https://www.raspberrypi.org/) at home."
  484. msgstr ""
  485. #: ../../../docs/faq.md:168
  486. msgid ""
  487. "For us, a Kubernetes-based setup which requires a cluster of multiple "
  488. "computers and is more technically-involved is a no-go."
  489. msgstr ""
  490. #: ../../../docs/faq.md:170
  491. msgid ""
  492. "There are others working on automating a Matrix-on-Kubernetes setup, such"
  493. " as this [Helm](https://helm.sh/) chart: https://github.com/dacruz21"
  494. "/matrix-chart."
  495. msgstr ""
  496. #: ../../../docs/faq.md:172
  497. msgid "Why don't you use Podman instead of Docker?"
  498. msgstr ""
  499. #: ../../../docs/faq.md:174
  500. msgid ""
  501. "We like the philosophy of a daemonless container runtime, but "
  502. "[Podman](https://podman.io) is just not ready for our use case yet."
  503. msgstr ""
  504. #: ../../../docs/faq.md:176
  505. msgid ""
  506. "Learn more about our past experiences/attempts to give Podman a chance, "
  507. "by reading [this issue](https://github.com/spantaleev/matrix-docker-"
  508. "ansible-deploy/issues/520)."
  509. msgstr ""
  510. #: ../../../docs/faq.md:178
  511. msgid "In short, `alias podman=docker` is a lie (for us)."
  512. msgstr ""
  513. #: ../../../docs/faq.md:180
  514. msgid "Why use Docker?"
  515. msgstr ""
  516. #: ../../../docs/faq.md:182
  517. msgid ""
  518. "[Docker](https://www.docker.com/) is one of our 2 hard dependencies (the "
  519. "other one being [systemd](https://systemd.io/))."
  520. msgstr ""
  521. #: ../../../docs/faq.md:184
  522. msgid ""
  523. "It lets us run services in an isolated manner and independently of the "
  524. "(usually old) packages available for distributions."
  525. msgstr ""
  526. #: ../../../docs/faq.md:186
  527. msgid ""
  528. "It also lets us have a unified setup which runs the same across various "
  529. "supported distros (see them on [Prerequisites](prerequisites.md))."
  530. msgstr ""
  531. #: ../../../docs/faq.md:188
  532. msgid "Is Docker a hard requirement?"
  533. msgstr ""
  534. #: ../../../docs/faq.md:190
  535. msgid ""
  536. "Yes. See [Why don't you use Podman instead of Docker?](#why-dont-you-use-"
  537. "podman-instead-of-docker) for why we're not using another container "
  538. "runtime."
  539. msgstr ""
  540. #: ../../../docs/faq.md:192
  541. msgid ""
  542. "All of our services run in containers. It's how we achieve predictability"
  543. " and also how we support tens of different services across lots of "
  544. "distros."
  545. msgstr ""
  546. #: ../../../docs/faq.md:194
  547. msgid ""
  548. "The only thing we need on the distro is systemd and Python (we install "
  549. "Docker ourselves, unless you ask us not to)."
  550. msgstr ""
  551. #: ../../../docs/faq.md:196
  552. msgid "Why don't you use docker-compose?"
  553. msgstr ""
  554. #: ../../../docs/faq.md:198
  555. msgid ""
  556. "Instead of using [docker-compose](https://docs.docker.com/compose/), we "
  557. "prefer installing systemd services and scheduling those independently."
  558. msgstr ""
  559. #: ../../../docs/faq.md:200
  560. msgid ""
  561. "There are people who have worked on turning this setup into a docker-"
  562. "compose-based one. See these experiments "
  563. "[here](https://github.com/spantaleev/matrix-docker-ansible-"
  564. "deploy/issues/64#issuecomment-603164625). There is also a demo project "
  565. "([element-docker-demo](https://github.com/element-hq/element-docker-"
  566. "demo)) by Element."
  567. msgstr ""
  568. #: ../../../docs/faq.md:202
  569. msgid "Can I run this on a distro without systemd?"
  570. msgstr ""
  571. #: ../../../docs/faq.md:204
  572. msgid ""
  573. "No. [systemd](https://systemd.io/) is one of our 2 hard dependencies (the"
  574. " other one being [Docker](https://www.docker.com/))."
  575. msgstr ""
  576. #: ../../../docs/faq.md:206
  577. msgid "Can I install this on a Raspberry Pi?"
  578. msgstr ""
  579. #: ../../../docs/faq.md:208
  580. msgid ""
  581. "Yes, you can. See our [Alternative Architectures](alternative-"
  582. "architectures.md) documentation page."
  583. msgstr ""
  584. #: ../../../docs/faq.md:210
  585. msgid ""
  586. "Whether a Raspberry Pi has enough power to give you a good experience is "
  587. "another question. It depends on your use case."
  588. msgstr ""
  589. #: ../../../docs/faq.md:212
  590. msgid ""
  591. "Also see: [What kind of server specs do I need?](#what-kind-of-server-"
  592. "specs-do-i-need)."
  593. msgstr ""
  594. #: ../../../docs/faq.md:214
  595. msgid "What kind of server specs do I need?"
  596. msgstr ""
  597. #: ../../../docs/faq.md:216
  598. msgid ""
  599. "This largely depends on your use case. It's not so much the number of "
  600. "users that you plan to host, but rather the number of large rooms they "
  601. "will join."
  602. msgstr ""
  603. #: ../../../docs/faq.md:218
  604. msgid ""
  605. "Federated rooms with lots of history and containing hundreds of other "
  606. "servers are very heavy CPU-wise and memory-wise."
  607. msgstr ""
  608. #: ../../../docs/faq.md:220
  609. msgid ""
  610. "You can probably use a 1 CPU + 1GB memory server to host hundreds of "
  611. "local users just fine, but as soon as one of them joins a federated room "
  612. "like `#matrix:matrix.org` (Matrix HQ) or some IRC-bridged room (say "
  613. "`##linux`), your server will get the need for a lot more power (at least "
  614. "2GB RAM, etc)."
  615. msgstr ""
  616. #: ../../../docs/faq.md:222
  617. msgid ""
  618. "Running Matrix on a server with 1GB of memory is possible (especially if "
  619. "you disable some not-so-important services). See [How do I optimize this "
  620. "setup for a low-power server?](#how-do-i-optimize-this-setup-for-a-low-"
  621. "power-server)."
  622. msgstr ""
  623. #: ../../../docs/faq.md:224
  624. msgid ""
  625. "**We recommend starting with a server having at least 2GB of memory** and"
  626. " even then using it sparingly. If you know for sure you'll be joining "
  627. "various large rooms, etc., then going for 4GB of memory or more is a good"
  628. " idea."
  629. msgstr ""
  630. #: ../../../docs/faq.md:226
  631. msgid ""
  632. "Besides the regular Matrix stuff, we also support things like video-"
  633. "conferencing using [Jitsi](configuring-playbook-jitsi.md) and other "
  634. "additional services which (when installed) may use up a lot of memory. "
  635. "Things do add up. Besides the Synapse Matrix server, Jitsi is especially "
  636. "notorious for consuming a lot of resources. If you plan on running Jitsi,"
  637. " we recommend a server with at least 2GB of memory (preferrably more). "
  638. "See our [Jitsi documentation page](configuring-playbook-jitsi.md) to "
  639. "learn how to optimize its memory/CPU usage."
  640. msgstr ""
  641. #: ../../../docs/faq.md:228
  642. msgid "Can I run this in an LXC container?"
  643. msgstr ""
  644. #: ../../../docs/faq.md:230
  645. msgid ""
  646. "If your distro runs within an [LXC "
  647. "container](https://linuxcontainers.org/), you may hit [this "
  648. "issue](https://github.com/spantaleev/matrix-docker-ansible-"
  649. "deploy/issues/703). It can be worked around, if absolutely necessary, but"
  650. " we suggest that you avoid running from within an LXC container."
  651. msgstr ""
  652. #: ../../../docs/faq.md:232
  653. msgid "Configuration"
  654. msgstr ""
  655. #: ../../../docs/faq.md:234
  656. msgid "Why install my server at matrix.example.com and not at the base domain?"
  657. msgstr ""
  658. #: ../../../docs/faq.md:236
  659. msgid ""
  660. "It's the same with email servers. Your email address is likely "
  661. "`name@company.com`, not `name@mail.company.com`, even though it's "
  662. "`mail.company.com` that is really handling your data for `@company.com` "
  663. "email to work."
  664. msgstr ""
  665. #: ../../../docs/faq.md:238
  666. msgid ""
  667. "Using a separate domain name is easier to manage (although it's a little "
  668. "hard to get right at first) and keeps your Matrix server isolated from "
  669. "your website (if you have one), from your email server (if you have one),"
  670. " etc. Therefore, this playbook sets up services on your Matrix server "
  671. "(`matrix.example.com`) by default."
  672. msgstr ""
  673. #: ../../../docs/faq.md:240
  674. msgid ""
  675. "I don't control anything on the base domain and can't set up delegation "
  676. "to matrix.example.com. What do I do?"
  677. msgstr ""
  678. #: ../../../docs/faq.md:242
  679. msgid ""
  680. "If you're not in control of your base domain (or the server handling it) "
  681. "at all, you can take a look at [How do I install on matrix.example.com "
  682. "without involving the base domain?](#how-do-i-install-on-"
  683. "matrixexamplecom-without-involving-the-base-domain)"
  684. msgstr ""
  685. #: ../../../docs/faq.md:244
  686. msgid "I can't set up HTTPS on the base domain. How will I get Matrix federating?"
  687. msgstr ""
  688. #: ../../../docs/faq.md:246
  689. msgid ""
  690. "If you really can't obtain an HTTPS certificate for your base domain, you"
  691. " can take a look at [How do I install on matrix.example.com without "
  692. "involving the base domain?](#how-do-i-install-on-matrixexamplecom-"
  693. "without-involving-the-base-domain)"
  694. msgstr ""
  695. #: ../../../docs/faq.md:248
  696. msgid "How do I install on matrix.example.com without involving the base domain?"
  697. msgstr ""
  698. #: ../../../docs/faq.md:250
  699. msgid ""
  700. "Add the following configuration to your "
  701. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  702. msgstr ""
  703. #: ../../../docs/faq.md:271
  704. msgid ""
  705. "After configuring the playbook, run it with [playbook tags](playbook-"
  706. "tags.md) as below:"
  707. msgstr ""
  708. #: ../../../docs/faq.md:278
  709. msgid "**Notes**:"
  710. msgstr ""
  711. #: ../../../docs/faq.md:280
  712. msgid ""
  713. "The shortcut commands with the [`just` program](just.md) are also "
  714. "available: `just install-all` or `just setup-all`"
  715. msgstr ""
  716. #: ../../../docs/faq.md:282
  717. msgid ""
  718. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
  719. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
  720. "runtime) than `just setup-all`) when its components remain unchanged. If "
  721. "you adjust your `vars.yml` to remove other components, you'd need to run "
  722. "`just setup-all`, or these components will still remain installed. Note "
  723. "these shortcuts run the `ensure-matrix-users-created` tag too."
  724. msgstr ""
  725. #: ../../../docs/faq.md:284
  726. msgid ""
  727. "Without setting up [server delegation](howto-server-delegation.md) to "
  728. "`matrix.example.com`, your user IDs will be like "
  729. "`@alice:matrix.example.com`. This is equivalent to having an email "
  730. "address like `bob@mail.company.com`, instead of just `bob@company.com`."
  731. msgstr ""
  732. #: ../../../docs/faq.md:286
  733. msgid ""
  734. "I don't use the base domain for anything. How am I supposed to set up "
  735. "Server Delegation for Matrix services?"
  736. msgstr ""
  737. #: ../../../docs/faq.md:288
  738. msgid ""
  739. "If you don't use your base domain for anything, then it's hard for you to"
  740. " \"serve files over HTTPS\" on it -- something we ask you to do for the "
  741. "[.well-known](configuring-well-known.md) setup (needed for [Server "
  742. "Delegation](howto-server-delegation.md))."
  743. msgstr ""
  744. #: ../../../docs/faq.md:290
  745. msgid ""
  746. "Luckily, the playbook can set up your Matrix server (at "
  747. "`matrix.example.com`) to also handle traffic for the base domain "
  748. "(`example.com`)."
  749. msgstr ""
  750. #: ../../../docs/faq.md:292
  751. msgid ""
  752. "See [Serving the base domain](configuring-playbook-base-domain-"
  753. "serving.md)."
  754. msgstr ""
  755. #: ../../../docs/faq.md:294
  756. msgid "How do I optimize this setup for a low-power server?"
  757. msgstr ""
  758. #: ../../../docs/faq.md:296
  759. msgid "You can disable some not-so-important services to save on memory."
  760. msgstr ""
  761. #: ../../../docs/faq.md:318
  762. msgid ""
  763. "You can also consider implementing a restriction on room complexity, in "
  764. "order to prevent users from joining very heavy rooms:"
  765. msgstr ""
  766. #: ../../../docs/faq.md:328
  767. msgid ""
  768. "If you've installed [Jitsi](configuring-playbook-jitsi.md) (not installed"
  769. " by default), there are additional optimizations listed on its "
  770. "documentation page that you can perform."
  771. msgstr ""
  772. #: ../../../docs/faq.md:330
  773. msgid ""
  774. "I already have Docker on my server. Can you stop installing Docker via "
  775. "the playbook?"
  776. msgstr ""
  777. #: ../../../docs/faq.md:332
  778. msgid ""
  779. "Yes, we can stop installing Docker ourselves. Just use this in your "
  780. "`vars.yml` file:"
  781. msgstr ""
  782. #: ../../../docs/faq.md:338
  783. msgid ""
  784. "I run another webserver on the same server where I wish to install "
  785. "Matrix. What now?"
  786. msgstr ""
  787. #: ../../../docs/faq.md:340
  788. msgid ""
  789. "By default, we install a webserver for you "
  790. "([Traefik](https://doc.traefik.io/traefik/)), but you can also use [your "
  791. "own webserver](configuring-playbook-own-webserver.md)."
  792. msgstr ""
  793. #: ../../../docs/faq.md:342
  794. msgid "How is the effective configuration determined?"
  795. msgstr ""
  796. #: ../../../docs/faq.md:344
  797. msgid ""
  798. "Configuration variables are defined in multiple places in this playbook "
  799. "and are considered in this order:"
  800. msgstr ""
  801. #: ../../../docs/faq.md:346
  802. msgid ""
  803. "there are defaults coming from each role's defaults file "
  804. "(`role/matrix*/defaults/main.yml`). These variable values aim to be good "
  805. "defaults for when the role is used standalone (outside of this collection"
  806. " of roles, also called playbook)."
  807. msgstr ""
  808. #: ../../../docs/faq.md:348
  809. msgid ""
  810. "then, there are overrides in `group_vars/matrix_servers`, which aim to "
  811. "adjust these \"standalone role defaults\" to something which better fits "
  812. "the playbook in its entirety."
  813. msgstr ""
  814. #: ../../../docs/faq.md:350
  815. msgid ""
  816. "finally, there's your `inventory/host_vars/matrix.example.com/vars.yml` "
  817. "file, which is the ultimate override"
  818. msgstr ""
  819. #: ../../../docs/faq.md:352
  820. msgid "What configuration variables are available?"
  821. msgstr ""
  822. #: ../../../docs/faq.md:354
  823. msgid ""
  824. "You can discover the variables you can override in each role "
  825. "(`roles/*/*/defaults/main.yml`)."
  826. msgstr ""
  827. #: ../../../docs/faq.md:356
  828. msgid ""
  829. "As described in [How is the effective configuration determined?](#how-is-"
  830. "the-effective-configuration-determined), these role-defaults may be "
  831. "overriden by values defined in `group_vars/matrix_servers`."
  832. msgstr ""
  833. #: ../../../docs/faq.md:358
  834. msgid ""
  835. "Refer to both of these for inspiration. Still, as mentioned in "
  836. "[Configuring the playbook](configuring-playbook.md), you're only ever "
  837. "supposed to edit your own "
  838. "`inventory/host_vars/matrix.example.com/vars.yml` file and nothing else "
  839. "inside the playbook (unless you're meaning to contribute new features)."
  840. msgstr ""
  841. #: ../../../docs/faq.md:360 ../../../docs/faq.md:372
  842. msgid ""
  843. "**Note**: some of the roles (`roles/galaxy/*`) live in separate "
  844. "repositories and are only installed after your run `just roles` (or `make"
  845. " roles`) or `just update` (which automatically does `git pull` and `just "
  846. "roles`)."
  847. msgstr ""
  848. #: ../../../docs/faq.md:362
  849. msgid ""
  850. "I'd like to adjust some configuration which doesn't have a corresponding "
  851. "variable. How do I do it?"
  852. msgstr ""
  853. #: ../../../docs/faq.md:364
  854. msgid ""
  855. "The playbook doesn't aim to expose all configuration settings for all "
  856. "services using variables. Doing so would amount to hundreds of variables "
  857. "that we have to create and maintain."
  858. msgstr ""
  859. #: ../../../docs/faq.md:366
  860. msgid ""
  861. "Instead, we only try to make some important basics configurable using "
  862. "dedicated variables you can see in each role. See [What configuration "
  863. "variables are available?](#what-configuration-variables-are-available)."
  864. msgstr ""
  865. #: ../../../docs/faq.md:368
  866. msgid ""
  867. "Besides that, each role (component) aims to provide a "
  868. "`matrix_SOME_COMPONENT_configuration_extension_yaml` (or "
  869. "`matrix_SOME_COMPONENT_configuration_extension_json`) variable, which can"
  870. " be used to override the configuration."
  871. msgstr ""
  872. #: ../../../docs/faq.md:370
  873. msgid ""
  874. "Check each role's `roles/*/*/defaults/main.yml` for the corresponding "
  875. "variable and an example for how use it."
  876. msgstr ""
  877. #: ../../../docs/faq.md:374
  878. msgid "Installation"
  879. msgstr ""
  880. #: ../../../docs/faq.md:376
  881. msgid "How do I run the installation?"
  882. msgstr ""
  883. #: ../../../docs/faq.md:378
  884. msgid ""
  885. "See [Installing](installing.md) to learn how to use Ansible to install "
  886. "Matrix services."
  887. msgstr ""
  888. #: ../../../docs/faq.md:380
  889. msgid ""
  890. "However, we recommend you to follow our installation guide, instead of "
  891. "jumping straight to installing."
  892. msgstr ""
  893. #: ../../../docs/faq.md:382
  894. msgid "There are two guides available:"
  895. msgstr ""
  896. #: ../../../docs/faq.md:384
  897. msgid ""
  898. "⚡ **[Quick start](quick-start.md)** (for beginners): this is recommended "
  899. "for those who do not have an existing Matrix server and want to start "
  900. "quickly with \"opinionated defaults\"."
  901. msgstr ""
  902. #: ../../../docs/faq.md:386
  903. msgid ""
  904. "**Full installation guide (for advanced users)**: if you need to import "
  905. "an existing Matrix server's data into the new server or want to learn "
  906. "more while setting up the server, follow this guide by starting with the "
  907. "**[Prerequisites](prerequisites.md)** documentation page."
  908. msgstr ""
  909. #: ../../../docs/faq.md:388
  910. msgid ""
  911. "I installed Synapse some other way. Can I migrate such a setup to the "
  912. "playbook?"
  913. msgstr ""
  914. #: ../../../docs/faq.md:390
  915. msgid "Yes, you can."
  916. msgstr ""
  917. #: ../../../docs/faq.md:392
  918. msgid ""
  919. "You generally need to do a playbook installation. It's recommended to "
  920. "follow the full installation guide (starting at the "
  921. "[Prerequisites](prerequisites.md) page), not the [Quick start](quick-"
  922. "start.md) guide. The full installation guide will tell you when it's time"
  923. " to import your existing data into the newly-prepared server."
  924. msgstr ""
  925. #: ../../../docs/faq.md:394
  926. msgid ""
  927. "This Ansible playbook guides you into installing a server for "
  928. "`example.com` (user IDs are like this: `@alice:example.com`), while the "
  929. "server is at `matrix.example.com`. If your existing setup has a server "
  930. "name (`server_name` configuration setting in Synapse's `homeserver.yaml` "
  931. "file) other than the base `example.com`, you may need to tweak some "
  932. "additional variables. This FAQ entry may be of use if you're dealing with"
  933. " a more complicated setup - [How do I install on matrix.example.com "
  934. "without involving the base domain?](#how-do-i-install-on-"
  935. "matrixexamplecom-without-involving-the-base-domain)"
  936. msgstr ""
  937. #: ../../../docs/faq.md:396
  938. msgid ""
  939. "After configuring the playbook and installing and **before starting** "
  940. "services (done with `ansible-playbook … --tags=start`) you'd import [your"
  941. " SQLite](importing-synapse-sqlite.md) (or [Postgres](importing-"
  942. "postgres.md)) database and also [import your media store](importing-"
  943. "synapse-media-store.md)."
  944. msgstr ""
  945. #: ../../../docs/faq.md:398
  946. msgid ""
  947. "I've downloaded Ansible and the playbook on the server. It can't connect "
  948. "using SSH."
  949. msgstr ""
  950. #: ../../../docs/faq.md:400
  951. msgid ""
  952. "If you're using the playbook directly on the server, then Ansible doesn't"
  953. " need to connect using SSH."
  954. msgstr ""
  955. #: ../../../docs/faq.md:402
  956. msgid ""
  957. "It can perform a local connection instead. Just set "
  958. "`ansible_connection=local` at the end of the server line in "
  959. "`inventory/hosts` and re-run the playbook."
  960. msgstr ""
  961. #: ../../../docs/faq.md:404
  962. msgid ""
  963. "If you're running Ansible from within a container (one of the "
  964. "possibilities we list on our [dedicated Ansible documentation "
  965. "page](ansible.md)), then using `ansible_connection=local` is not "
  966. "possible."
  967. msgstr ""
  968. #: ../../../docs/faq.md:406
  969. msgid "Troubleshooting"
  970. msgstr ""
  971. #: ../../../docs/faq.md:408
  972. msgid ""
  973. "I get \"Error response from daemon: configured logging driver does not "
  974. "support reading\" when I do `docker logs matrix-synapse`."
  975. msgstr ""
  976. #: ../../../docs/faq.md:410
  977. msgid "See [How can I see the logs?](#how-can-i-see-the-logs)."
  978. msgstr ""
  979. #: ../../../docs/faq.md:412
  980. msgid "How can I see the logs?"
  981. msgstr ""
  982. #: ../../../docs/faq.md:414
  983. msgid ""
  984. "We utilize "
  985. "[systemd/journald](https://www.freedesktop.org/software/systemd/man"
  986. "/systemd-journald.service.html#Description) for logging."
  987. msgstr ""
  988. #: ../../../docs/faq.md:416
  989. msgid ""
  990. "To see logs for Synapse, run `journalctl -fu matrix-synapse.service`. You"
  991. " may wish to see the [manual page for "
  992. "journalctl](https://www.commandlinux.com/man-"
  993. "page/man1/journalctl.1.html)."
  994. msgstr ""
  995. #: ../../../docs/faq.md:418
  996. msgid ""
  997. "Available service names can be seen by doing `ls "
  998. "/etc/systemd/system/matrix*.service` on the server."
  999. msgstr ""
  1000. #: ../../../docs/faq.md:420
  1001. msgid ""
  1002. "Some services also log to files in `/matrix/*/data/..`, but we're slowly "
  1003. "moving away from that."
  1004. msgstr ""
  1005. #: ../../../docs/faq.md:422
  1006. msgid ""
  1007. "We also disable Docker logging, so you can't use `docker logs matrix-*` "
  1008. "either. We do this to prevent useless double (or even triple) logging and"
  1009. " to avoid having to rotate log files."
  1010. msgstr ""
  1011. #: ../../../docs/faq.md:424
  1012. msgid ""
  1013. "We just simply delegate logging to journald and it takes care of "
  1014. "persistence and expiring old data."
  1015. msgstr ""
  1016. #: ../../../docs/faq.md:426
  1017. msgid ""
  1018. "Also see: [How long do systemd/journald logs persist for?](#how-long-do-"
  1019. "systemdjournald-logs-persist-for)"
  1020. msgstr ""
  1021. #: ../../../docs/faq.md:428
  1022. msgid "How long do systemd/journald logs persist for?"
  1023. msgstr ""
  1024. #: ../../../docs/faq.md:430
  1025. msgid ""
  1026. "On some distros, the journald logs are just in-memory and not persisted "
  1027. "to disk."
  1028. msgstr ""
  1029. #: ../../../docs/faq.md:432
  1030. msgid ""
  1031. "Consult (and feel free to adjust) your distro's journald logging "
  1032. "configuration in `/etc/systemd/journald.conf`."
  1033. msgstr ""
  1034. #: ../../../docs/faq.md:434
  1035. msgid ""
  1036. "To enable persistence and put some limits on how large the journal log "
  1037. "files can become, adjust your configuration like this:"
  1038. msgstr ""
  1039. #: ../../../docs/faq.md:445
  1040. msgid "Maintenance"
  1041. msgstr ""
  1042. #: ../../../docs/faq.md:447
  1043. msgid "Do I need to do anything to keep my Matrix server updated?"
  1044. msgstr ""
  1045. #: ../../../docs/faq.md:449
  1046. msgid "Yes. We don't update anything for you automatically."
  1047. msgstr ""
  1048. #: ../../../docs/faq.md:451
  1049. msgid ""
  1050. "See our [documentation page about upgrading services](maintenance-"
  1051. "upgrading-services.md)."
  1052. msgstr ""
  1053. #: ../../../docs/faq.md:453
  1054. msgid "How do I move my existing installation to another (VM) server?"
  1055. msgstr ""
  1056. #: ../../../docs/faq.md:455
  1057. msgid ""
  1058. "If you have an existing installation done using this Ansible playbook, "
  1059. "you can easily migrate that to another server using [our dedicated server"
  1060. " migration guide](maintenance-migrating.md)."
  1061. msgstr ""
  1062. #: ../../../docs/faq.md:457
  1063. msgid ""
  1064. "If your previous installation is done in some other way (not using this "
  1065. "Ansible playbook), see [I installed Synapse some other way. Can I migrate"
  1066. " such a setup to the playbook?](#i-installed-synapse-some-other-way-can-i"
  1067. "-migrate-such-a-setup-to-the-playbook)."
  1068. msgstr ""
  1069. #: ../../../docs/faq.md:459
  1070. msgid "How do I back up the data on my server?"
  1071. msgstr ""
  1072. #: ../../../docs/faq.md:461
  1073. msgid "We haven't documented this properly yet, but the general advice is to:"
  1074. msgstr ""
  1075. #: ../../../docs/faq.md:463
  1076. msgid ""
  1077. "back up Postgres by making a database dump. See [Backing up PostgreSQL"
  1078. "](maintenance-postgres.md#backing-up-postgresql)"
  1079. msgstr ""
  1080. #: ../../../docs/faq.md:465
  1081. msgid ""
  1082. "back up all `/matrix` files, except for `/matrix/postgres/data` (you "
  1083. "already have a dump) and `/matrix/postgres/data-auto-upgrade-backup` "
  1084. "(this directory may exist and contain your old data if you've [performed "
  1085. "a major Postgres upgrade](maintenance-postgres.md#upgrading-postgresql))."
  1086. msgstr ""
  1087. #: ../../../docs/faq.md:467
  1088. msgid "You can later restore these by:"
  1089. msgstr ""
  1090. #: ../../../docs/faq.md:469
  1091. msgid "Restoring the `/matrix` directory and files on the new server manually"
  1092. msgstr ""
  1093. #: ../../../docs/faq.md:470
  1094. msgid ""
  1095. "Following the instruction described on [Installing a server into which "
  1096. "you'll import old data](installing.md#installing-a-server-into-which-"
  1097. "youll-import-old-data)"
  1098. msgstr ""
  1099. #: ../../../docs/faq.md:472
  1100. msgid ""
  1101. "If your server's IP address has changed, you may need to [set up DNS"
  1102. "](configuring-dns.md) again."
  1103. msgstr ""
  1104. #: ../../../docs/faq.md:474
  1105. msgid ""
  1106. "What is this `/matrix/postgres/data-auto-upgrade-backup` directory that "
  1107. "is taking up so much space?"
  1108. msgstr ""
  1109. #: ../../../docs/faq.md:476
  1110. msgid ""
  1111. "When you [perform a major Postgres upgrade](maintenance-postgres.md"
  1112. "#upgrading-postgresql), we save the the old data files in "
  1113. "`/matrix/postgres/data-auto-upgrade-backup`, just so you could easily "
  1114. "restore them should something have gone wrong."
  1115. msgstr ""
  1116. #: ../../../docs/faq.md:478
  1117. msgid ""
  1118. "After verifying that everything still works after the Postgres upgrade, "
  1119. "you can safely delete `/matrix/postgres/data-auto-upgrade-backup`"
  1120. msgstr ""
  1121. #: ../../../docs/faq.md:480
  1122. msgid "How do I debug or force SSL certificate renewal?"
  1123. msgstr ""
  1124. #: ../../../docs/faq.md:482
  1125. msgid ""
  1126. "SSL certificates are managed automatically by the "
  1127. "[Traefik](https://doc.traefik.io/traefik/) reverse-proxy server."
  1128. msgstr ""
  1129. #: ../../../docs/faq.md:484
  1130. msgid ""
  1131. "If you're having trouble with SSL certificate renewal, check the Traefik "
  1132. "logs (`journalctl -fu matrix-traefik`)."
  1133. msgstr ""
  1134. #: ../../../docs/faq.md:486
  1135. msgid ""
  1136. "If you're [using your own webserver](configuring-playbook-own-"
  1137. "webserver.md) instead of the integrated one (Traefik), you should "
  1138. "investigate in another way."
  1139. msgstr ""