mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-23 21:15:45 +00:00
d4f8d0918a
Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
1355 lines
41 KiB
Plaintext
1355 lines
41 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
|
|
# members
|
|
# This file is distributed under the same license as the
|
|
# matrix-docker-ansible-deploy package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2024-12-16 12:05+0900\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language: jp\n"
|
|
"Language-Team: jp <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=utf-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Generated-By: Babel 2.16.0\n"
|
|
|
|
#: ../../../docs/faq.md:1
|
|
msgid "Frequently Asked Questions"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:3
|
|
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))."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:5
|
|
msgid ""
|
|
"This FAQ page does not intend to replace the [matrix.org "
|
|
"FAQ](https://matrix.org/faq/) (please see that one too)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:7
|
|
msgid "We've only started this FAQ recently, so it's still somewhat empty."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:9
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:11
|
|
msgid "Introductory"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:13
|
|
msgid "Where do I find more questions and answers about Matrix?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:15
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:17
|
|
msgid ""
|
|
"For a lot more generic questions and answers, see the [matrix.org "
|
|
"FAQ](https://matrix.org/faq/)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:19
|
|
msgid ""
|
|
"What is Matrix? What is Element? What is Synapse? Why are you confusing "
|
|
"me with so many terms?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:21
|
|
msgid ""
|
|
"[Matrix](https://matrix.org/) is a new type of realtime communication "
|
|
"(chat) network, the closest analogy to which is probably \"email\"."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:23
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:25
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:27
|
|
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`)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:29
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:31
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:33
|
|
msgid "In short:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:35
|
|
msgid ""
|
|
"Matrix is the protocol - a set of rules about how the chat network "
|
|
"operates"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:36
|
|
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/)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:37
|
|
msgid ""
|
|
"Synapse is a server program you can use to host your very own Matrix "
|
|
"server."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:39
|
|
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/)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:41
|
|
msgid "People I wish to talk to are not on Matrix. Can I talk to them?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:43
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:45
|
|
msgid ""
|
|
"This Ansible playbook can help you install [tens of bridges for various "
|
|
"networks](configuring-playbook.md#bridging-other-networks)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:47
|
|
msgid ""
|
|
"Besides setting up your own bridges (preferable), you can also use some "
|
|
"[public bridges hosted by others](https://publiclist.anchel.nl/#bridges)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:49
|
|
msgid "How do I get started with Matrix?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:51
|
|
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`)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:53
|
|
msgid ""
|
|
"There are 3 ways to get into Matrix, depending on your technical ability "
|
|
"and needs:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:55
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:57
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:59
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:61
|
|
msgid "How do I set up my own Matrix server?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:63
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:65
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:67
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:69
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:71
|
|
msgid "What is Ansible? How does it work?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:73
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:75
|
|
msgid ""
|
|
"We have written these automated tasks for you and all you need to do is "
|
|
"execute them using the Ansible program."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:77
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:79
|
|
msgid ""
|
|
"Alternatively, you can download Ansible and the playbook itself directly "
|
|
"on the `matrix.example.com` server."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:81
|
|
msgid "To learn more, see our [dedicated Ansible documentation page](ansible.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:83
|
|
msgid "What is `just`?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:85
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:87
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:89
|
|
msgid ""
|
|
"For details about `just` commands, take a look at: [Running `just` "
|
|
"commands](just.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:91
|
|
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`."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:93
|
|
msgid "Why use this playbook and not install Synapse and other things manually?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:95
|
|
msgid ""
|
|
"There are various guides telling you how easy it is to install "
|
|
"[Synapse](https://github.com/element-hq/synapse)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:97
|
|
msgid ""
|
|
"Reading the documentation of this Ansible playbook, you may also be "
|
|
"thinking:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:99
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:101
|
|
msgid ""
|
|
".. so you may be leaning toward [installing Synapse "
|
|
"manually](https://github.com/element-hq/synapse/blob/master/INSTALL.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:103
|
|
msgid "The problem with a manual installation is:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:105
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:106
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:107
|
|
msgid ""
|
|
"you may also need a reverse-proxy server in front of it (nginx, Apache), "
|
|
"so you'd need to be familiar with that"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:108
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:109
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:110
|
|
msgid ""
|
|
"you'll likely get slower updates for all of these components, depending "
|
|
"on your distro packaging or your own time and ability"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:112
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:114
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:116
|
|
msgid "Why use this playbook and not just use the Docker image directly?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:118
|
|
msgid "Reasons are similar to the reasons for not installing manually."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:120
|
|
msgid ""
|
|
"Besides Synapse, you'd need other things - a Postgres database, likely "
|
|
"the [Element](https://element.io) client, etc., etc."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:122
|
|
msgid ""
|
|
"Using the playbook, you get all these components in a way that works well"
|
|
" together out of the box."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:124
|
|
msgid "Occasionally I see some people are talking about \"MDAD\". What is it?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:126
|
|
msgid "It is the acronym of us: **m**atrix-**d**ocker-**a**nsible-**d**eploy."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:128
|
|
msgid ""
|
|
"What's different about this Ansible playbook compared to [EMnify/matrix-"
|
|
"synapse-auto-deploy](https://github.com/EMnify/matrix-synapse-auto-"
|
|
"deploy)?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:130
|
|
msgid ""
|
|
"This is similar to the [EMnify/matrix-synapse-auto-"
|
|
"deploy](https://github.com/EMnify/matrix-synapse-auto-deploy) Ansible "
|
|
"deployment, but:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:132
|
|
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"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:134
|
|
msgid ""
|
|
"this one installs and hooks together **a lot more Matrix-related "
|
|
"services** for you (see above)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:136
|
|
msgid "this one **can be executed more than once** without causing trouble"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:138
|
|
msgid ""
|
|
"works on various distros: **CentOS** (7.0+), Debian-based distributions "
|
|
"(**Debian** 10/Buster+, **Ubuntu** 18.04+), **Archlinux**"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:140
|
|
msgid ""
|
|
"this one installs everything in a single directory (`/matrix` by default)"
|
|
" and **doesn't \"contaminate\" your server** with files all over the "
|
|
"place"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:142
|
|
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)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:144
|
|
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))"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:146
|
|
msgid ""
|
|
"this one retrieves and automatically renews free [Let's "
|
|
"Encrypt](https://letsencrypt.org/) **SSL certificates** for you"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:148
|
|
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)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:150
|
|
msgid ""
|
|
"this one optionally **allows you to use an external PostgreSQL server** "
|
|
"for Synapse's database (but defaults to running one in a container)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:152
|
|
msgid ""
|
|
"helps you **import data from a previous installation** (so you can "
|
|
"migrate your manual virtualenv/Docker setup to a more managed one)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:154
|
|
msgid "this one is actually **maintained**"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:156
|
|
msgid "Server-related"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:158
|
|
msgid ""
|
|
"What kind of server do I need to install Matrix using this Ansible "
|
|
"playbook?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:160
|
|
msgid "We list our server requirements in [Prerequisites](prerequisites.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:162
|
|
msgid "Why not run Matrix on Kubernetes?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:164
|
|
msgid ""
|
|
"There's no reason not to run Matrix on "
|
|
"[Kubernetes](https://kubernetes.io/)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:166
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:168
|
|
msgid ""
|
|
"For us, a Kubernetes-based setup which requires a cluster of multiple "
|
|
"computers and is more technically-involved is a no-go."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:170
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:172
|
|
msgid "Why don't you use Podman instead of Docker?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:174
|
|
msgid ""
|
|
"We like the philosophy of a daemonless container runtime, but "
|
|
"[Podman](https://podman.io) is just not ready for our use case yet."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:176
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:178
|
|
msgid "In short, `alias podman=docker` is a lie (for us)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:180
|
|
msgid "Why use Docker?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:182
|
|
msgid ""
|
|
"[Docker](https://www.docker.com/) is one of our 2 hard dependencies (the "
|
|
"other one being [systemd](https://systemd.io/))."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:184
|
|
msgid ""
|
|
"It lets us run services in an isolated manner and independently of the "
|
|
"(usually old) packages available for distributions."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:186
|
|
msgid ""
|
|
"It also lets us have a unified setup which runs the same across various "
|
|
"supported distros (see them on [Prerequisites](prerequisites.md))."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:188
|
|
msgid "Is Docker a hard requirement?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:190
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:192
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:194
|
|
msgid ""
|
|
"The only thing we need on the distro is systemd and Python (we install "
|
|
"Docker ourselves, unless you ask us not to)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:196
|
|
msgid "Why don't you use docker-compose?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:198
|
|
msgid ""
|
|
"Instead of using [docker-compose](https://docs.docker.com/compose/), we "
|
|
"prefer installing systemd services and scheduling those independently."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:200
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:202
|
|
msgid "Can I run this on a distro without systemd?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:204
|
|
msgid ""
|
|
"No. [systemd](https://systemd.io/) is one of our 2 hard dependencies (the"
|
|
" other one being [Docker](https://www.docker.com/))."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:206
|
|
msgid "Can I install this on a Raspberry Pi?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:208
|
|
msgid ""
|
|
"Yes, you can. See our [Alternative Architectures](alternative-"
|
|
"architectures.md) documentation page."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:210
|
|
msgid ""
|
|
"Whether a Raspberry Pi has enough power to give you a good experience is "
|
|
"another question. It depends on your use case."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:212
|
|
msgid ""
|
|
"Also see: [What kind of server specs do I need?](#what-kind-of-server-"
|
|
"specs-do-i-need)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:214
|
|
msgid "What kind of server specs do I need?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:216
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:218
|
|
msgid ""
|
|
"Federated rooms with lots of history and containing hundreds of other "
|
|
"servers are very heavy CPU-wise and memory-wise."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:220
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:222
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:224
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:226
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:228
|
|
msgid "Can I run this in an LXC container?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:230
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:232
|
|
msgid "Configuration"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:234
|
|
msgid "Why install my server at matrix.example.com and not at the base domain?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:236
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:238
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:240
|
|
msgid ""
|
|
"I don't control anything on the base domain and can't set up delegation "
|
|
"to matrix.example.com. What do I do?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:242
|
|
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)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:244
|
|
msgid "I can't set up HTTPS on the base domain. How will I get Matrix federating?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:246
|
|
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)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:248
|
|
msgid "How do I install on matrix.example.com without involving the base domain?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:250
|
|
msgid ""
|
|
"Add the following configuration to your "
|
|
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:271
|
|
msgid ""
|
|
"After configuring the playbook, run it with [playbook tags](playbook-"
|
|
"tags.md) as below:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:278
|
|
msgid "**Notes**:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:280
|
|
msgid ""
|
|
"The shortcut commands with the [`just` program](just.md) are also "
|
|
"available: `just install-all` or `just setup-all`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:282
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:284
|
|
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`."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:286
|
|
msgid ""
|
|
"I don't use the base domain for anything. How am I supposed to set up "
|
|
"Server Delegation for Matrix services?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:288
|
|
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))."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:290
|
|
msgid ""
|
|
"Luckily, the playbook can set up your Matrix server (at "
|
|
"`matrix.example.com`) to also handle traffic for the base domain "
|
|
"(`example.com`)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:292
|
|
msgid ""
|
|
"See [Serving the base domain](configuring-playbook-base-domain-"
|
|
"serving.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:294
|
|
msgid "How do I optimize this setup for a low-power server?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:296
|
|
msgid "You can disable some not-so-important services to save on memory."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:318
|
|
msgid ""
|
|
"You can also consider implementing a restriction on room complexity, in "
|
|
"order to prevent users from joining very heavy rooms:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:328
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:330
|
|
msgid ""
|
|
"I already have Docker on my server. Can you stop installing Docker via "
|
|
"the playbook?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:332
|
|
msgid ""
|
|
"Yes, we can stop installing Docker ourselves. Just use this in your "
|
|
"`vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:338
|
|
msgid ""
|
|
"I run another webserver on the same server where I wish to install "
|
|
"Matrix. What now?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:340
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:342
|
|
msgid "How is the effective configuration determined?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:344
|
|
msgid ""
|
|
"Configuration variables are defined in multiple places in this playbook "
|
|
"and are considered in this order:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:346
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:348
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:350
|
|
msgid ""
|
|
"finally, there's your `inventory/host_vars/matrix.example.com/vars.yml` "
|
|
"file, which is the ultimate override"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:352
|
|
msgid "What configuration variables are available?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:354
|
|
msgid ""
|
|
"You can discover the variables you can override in each role "
|
|
"(`roles/*/*/defaults/main.yml`)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:356
|
|
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`."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:358
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:360 ../../../docs/faq.md:372
|
|
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`)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:362
|
|
msgid ""
|
|
"I'd like to adjust some configuration which doesn't have a corresponding "
|
|
"variable. How do I do it?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:364
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:366
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:368
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:370
|
|
msgid ""
|
|
"Check each role's `roles/*/*/defaults/main.yml` for the corresponding "
|
|
"variable and an example for how use it."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:374
|
|
msgid "Installation"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:376
|
|
msgid "How do I run the installation?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:378
|
|
msgid ""
|
|
"See [Installing](installing.md) to learn how to use Ansible to install "
|
|
"Matrix services."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:380
|
|
msgid ""
|
|
"However, we recommend you to follow our installation guide, instead of "
|
|
"jumping straight to installing."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:382
|
|
msgid "There are two guides available:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:384
|
|
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\"."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:386
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:388
|
|
msgid ""
|
|
"I installed Synapse some other way. Can I migrate such a setup to the "
|
|
"playbook?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:390
|
|
msgid "Yes, you can."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:392
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:394
|
|
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)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:396
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:398
|
|
msgid ""
|
|
"I've downloaded Ansible and the playbook on the server. It can't connect "
|
|
"using SSH."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:400
|
|
msgid ""
|
|
"If you're using the playbook directly on the server, then Ansible doesn't"
|
|
" need to connect using SSH."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:402
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:404
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:406
|
|
msgid "Troubleshooting"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:408
|
|
msgid ""
|
|
"I get \"Error response from daemon: configured logging driver does not "
|
|
"support reading\" when I do `docker logs matrix-synapse`."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:410
|
|
msgid "See [How can I see the logs?](#how-can-i-see-the-logs)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:412
|
|
msgid "How can I see the logs?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:414
|
|
msgid ""
|
|
"We utilize "
|
|
"[systemd/journald](https://www.freedesktop.org/software/systemd/man"
|
|
"/systemd-journald.service.html#Description) for logging."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:416
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:418
|
|
msgid ""
|
|
"Available service names can be seen by doing `ls "
|
|
"/etc/systemd/system/matrix*.service` on the server."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:420
|
|
msgid ""
|
|
"Some services also log to files in `/matrix/*/data/..`, but we're slowly "
|
|
"moving away from that."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:422
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:424
|
|
msgid ""
|
|
"We just simply delegate logging to journald and it takes care of "
|
|
"persistence and expiring old data."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:426
|
|
msgid ""
|
|
"Also see: [How long do systemd/journald logs persist for?](#how-long-do-"
|
|
"systemdjournald-logs-persist-for)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:428
|
|
msgid "How long do systemd/journald logs persist for?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:430
|
|
msgid ""
|
|
"On some distros, the journald logs are just in-memory and not persisted "
|
|
"to disk."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:432
|
|
msgid ""
|
|
"Consult (and feel free to adjust) your distro's journald logging "
|
|
"configuration in `/etc/systemd/journald.conf`."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:434
|
|
msgid ""
|
|
"To enable persistence and put some limits on how large the journal log "
|
|
"files can become, adjust your configuration like this:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:445
|
|
msgid "Maintenance"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:447
|
|
msgid "Do I need to do anything to keep my Matrix server updated?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:449
|
|
msgid "Yes. We don't update anything for you automatically."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:451
|
|
msgid ""
|
|
"See our [documentation page about upgrading services](maintenance-"
|
|
"upgrading-services.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:453
|
|
msgid "How do I move my existing installation to another (VM) server?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:455
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:457
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:459
|
|
msgid "How do I back up the data on my server?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:461
|
|
msgid "We haven't documented this properly yet, but the general advice is to:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:463
|
|
msgid ""
|
|
"back up Postgres by making a database dump. See [Backing up PostgreSQL"
|
|
"](maintenance-postgres.md#backing-up-postgresql)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:465
|
|
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))."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:467
|
|
msgid "You can later restore these by:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:469
|
|
msgid "Restoring the `/matrix` directory and files on the new server manually"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:470
|
|
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)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:472
|
|
msgid ""
|
|
"If your server's IP address has changed, you may need to [set up DNS"
|
|
"](configuring-dns.md) again."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:474
|
|
msgid ""
|
|
"What is this `/matrix/postgres/data-auto-upgrade-backup` directory that "
|
|
"is taking up so much space?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:476
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:478
|
|
msgid ""
|
|
"After verifying that everything still works after the Postgres upgrade, "
|
|
"you can safely delete `/matrix/postgres/data-auto-upgrade-backup`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:480
|
|
msgid "How do I debug or force SSL certificate renewal?"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:482
|
|
msgid ""
|
|
"SSL certificates are managed automatically by the "
|
|
"[Traefik](https://doc.traefik.io/traefik/) reverse-proxy server."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:484
|
|
msgid ""
|
|
"If you're having trouble with SSL certificate renewal, check the Traefik "
|
|
"logs (`journalctl -fu matrix-traefik`)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/faq.md:486
|
|
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."
|
|
msgstr ""
|
|
|