mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-23 13:05:47 +00:00
449 lines
14 KiB
Plaintext
449 lines
14 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/installing.md:1
|
|||
|
msgid "Installing"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:3
|
|||
|
msgid ""
|
|||
|
"<sup>[Prerequisites](prerequisites.md) > [Configuring your DNS settings"
|
|||
|
"](configuring-dns.md) > [Getting the playbook](getting-the-playbook.md) >"
|
|||
|
" [Configuring the playbook](configuring-playbook.md) > Installing</sup>"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:5
|
|||
|
msgid ""
|
|||
|
"If you've configured your DNS records and the playbook, you can start the"
|
|||
|
" installation procedure."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:7
|
|||
|
msgid "Update Ansible roles"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:9
|
|||
|
msgid ""
|
|||
|
"Before installing, you need to update the Ansible roles that this "
|
|||
|
"playbook uses and fetches from outside."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:11
|
|||
|
msgid ""
|
|||
|
"To update your playbook directory and all upstream Ansible roles (defined"
|
|||
|
" in the `requirements.yml` file), run:"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:13
|
|||
|
msgid "either: `just update`"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:14
|
|||
|
msgid ""
|
|||
|
"or: a combination of `git pull` and `just roles` (or `make roles` if you "
|
|||
|
"have `make` program on your computer instead of `just`)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:16
|
|||
|
msgid ""
|
|||
|
"If you don't have either `just` tool or `make` program, you can run the "
|
|||
|
"`ansible-galaxy` tool directly: `rm -rf roles/galaxy; ansible-galaxy "
|
|||
|
"install -r requirements.yml -p roles/galaxy/ --force`"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:18
|
|||
|
msgid ""
|
|||
|
"For details about `just` commands, take a look at: [Running `just` "
|
|||
|
"commands](just.md)."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:20
|
|||
|
msgid "Install Matrix server and services"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:22
|
|||
|
msgid ""
|
|||
|
"The Ansible playbook's tasks are tagged, so that certain parts of the "
|
|||
|
"Ansible playbook can be run without running all other tasks."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:24
|
|||
|
msgid ""
|
|||
|
"The general command syntax for installation (and also maintenance) is: "
|
|||
|
"`ansible-playbook -i inventory/hosts setup.yml "
|
|||
|
"--tags=COMMA_SEPARATED_TAGS_GO_HERE`. It is recommended to get yourself "
|
|||
|
"familiar with the [playbook tags](playbook-tags.md) before proceeding."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:26
|
|||
|
msgid ""
|
|||
|
"If you **don't** use SSH keys for authentication, but rather a regular "
|
|||
|
"password, you may need to add `--ask-pass` to the all Ansible commands."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:28
|
|||
|
msgid ""
|
|||
|
"If you **do** use SSH keys for authentication, **and** use a non-root "
|
|||
|
"user to *become* root (sudo), you may need to add `-K` (`--ask-become-"
|
|||
|
"pass`) to all Ansible commands."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:30
|
|||
|
msgid ""
|
|||
|
"There 2 ways to start the installation process - depending on whether "
|
|||
|
"you're [Installing a brand new server (without importing "
|
|||
|
"data)](#installing-a-brand-new-server-without-importing-data) or "
|
|||
|
"[Installing a server into which you'll import old data](#installing-a"
|
|||
|
"-server-into-which-youll-import-old-data)."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:32
|
|||
|
msgid ""
|
|||
|
"**Note**: if you are migrating from an old server to a new one, take a "
|
|||
|
"look at [this guide](maintenance-migrating.md) instead. This is an easier"
|
|||
|
" and more straightforward way than installing a server and importing old "
|
|||
|
"data into it."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:34
|
|||
|
msgid "Installing a brand new server (without importing data)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:36
|
|||
|
msgid ""
|
|||
|
"If this is **a brand new** Matrix server and you **won't be importing old"
|
|||
|
" data into it**, run all these tags:"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:42
|
|||
|
msgid "This will do a full installation and start all Matrix services."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:44
|
|||
|
msgid ""
|
|||
|
"**Note**: if the command does not work as expected, make sure that you "
|
|||
|
"have properly installed and configured software required to run the "
|
|||
|
"playbook, as described on [Prerequisites](prerequisites.md)."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:46
|
|||
|
msgid "Installing a server into which you'll import old data"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:48
|
|||
|
msgid ""
|
|||
|
"If you will be importing data into your newly created Matrix server, "
|
|||
|
"install it, but **do not** start its services just yet. Starting its "
|
|||
|
"services or messing with its database now will affect your data import "
|
|||
|
"later on."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:50
|
|||
|
msgid ""
|
|||
|
"To do the installation **without** starting services, run `ansible-"
|
|||
|
"playbook` with the `install-all` tag only:"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:56
|
|||
|
msgid ""
|
|||
|
"⚠️ **Warning**: do not run the just \"recipe\" `just install-all` "
|
|||
|
"instead, because it automatically starts services at the end of "
|
|||
|
"execution. See: [Difference between playbook tags and shortcuts](just.md"
|
|||
|
"#difference-between-playbook-tags-and-shortcuts)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:58
|
|||
|
msgid "When this command completes, services won't be running yet."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:60
|
|||
|
msgid "You can now:"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:62
|
|||
|
msgid ""
|
|||
|
"[Importing an existing SQLite database (from another Synapse installation"
|
|||
|
")](importing-synapse-sqlite.md) (optional)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:64
|
|||
|
msgid ""
|
|||
|
"[Importing an existing Postgres database (from another installation"
|
|||
|
")](importing-postgres.md) (optional)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:66
|
|||
|
msgid ""
|
|||
|
"[Importing `media_store` data files from an existing Synapse installation"
|
|||
|
"](importing-synapse-media-store.md) (optional)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:68
|
|||
|
msgid ".. and then proceed to starting all services:"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:74
|
|||
|
msgid "Create your user account"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:76
|
|||
|
msgid ""
|
|||
|
"ℹ️ *You can skip this step if you have installed a server and imported "
|
|||
|
"old data to it.*"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:78
|
|||
|
msgid ""
|
|||
|
"As you have configured your brand new server and the client, you need to "
|
|||
|
"**create your user account** on your Matrix server."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:80
|
|||
|
msgid ""
|
|||
|
"After creating the user account, you can log in to it with [Element Web"
|
|||
|
"](configuring-playbook-client-element-web.md) that this playbook has "
|
|||
|
"installed for you at this URL: `https://element.example.com/`."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:82
|
|||
|
msgid ""
|
|||
|
"To create your user account (as an administrator of the server) via this "
|
|||
|
"Ansible playbook, run the command below on your local computer."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:84
|
|||
|
msgid "**Notes**:"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:85
|
|||
|
msgid "Make sure to adjust `YOUR_USERNAME_HERE` and `YOUR_PASSWORD_HERE`"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:86
|
|||
|
msgid ""
|
|||
|
"For `YOUR_USERNAME_HERE`, use a plain username like `alice`, not your "
|
|||
|
"full ID (`@alice:example.com`)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:87
|
|||
|
msgid ""
|
|||
|
"Use `admin=yes` to make your user account an administrator of the Matrix "
|
|||
|
"server"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:95
|
|||
|
msgid ""
|
|||
|
"Feel free to create as many accounts (for friends, family, etc.) as you "
|
|||
|
"want. Still, perhaps you should grant full administrative access to your "
|
|||
|
"account only (with `admin=yes`), and others should be created with "
|
|||
|
"`admin=no`."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:97
|
|||
|
msgid ""
|
|||
|
"For more information, see the documentation for [registering users"
|
|||
|
"](registering-users.md)."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:99
|
|||
|
msgid "Finalize the installation"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:101
|
|||
|
msgid ""
|
|||
|
"Now you've configured Matrix services and your user account, you need to "
|
|||
|
"**finalize the installation process** by [setting up Matrix delegation "
|
|||
|
"(redirection)](howto-server-delegation.md), so that your Matrix server "
|
|||
|
"(`matrix.example.com`) can present itself as the base domain "
|
|||
|
"(`example.com`) in the Matrix network."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:103
|
|||
|
msgid ""
|
|||
|
"This is required for federation to work! Without a proper configuration, "
|
|||
|
"your server will effectively not be part of the Matrix network."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:105
|
|||
|
msgid ""
|
|||
|
"To configure the delegation, you have these two options. Choose one of "
|
|||
|
"them according to your situation."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:107
|
|||
|
msgid ""
|
|||
|
"If you can afford to point the base domain at the Matrix server, follow "
|
|||
|
"the instructions below which guide you into [serving the base domain"
|
|||
|
"](configuring-playbook-base-domain-serving.md) from the integrated web "
|
|||
|
"server. It will enable you to use a Matrix user ID like "
|
|||
|
"`@alice:example.com` while hosting services on a subdomain like "
|
|||
|
"`matrix.example.com`."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:108
|
|||
|
msgid ""
|
|||
|
"Alternatively, if you're using the base domain for other purposes and "
|
|||
|
"cannot point it to the Matrix server (and thus cannot \"serve the base "
|
|||
|
"domain\" from it), you most likely need to [manually install well-known "
|
|||
|
"files on the base domain's server](configuring-well-known.md#manually-"
|
|||
|
"installing-well-known-files-on-the-base-domains-server), but feel free to"
|
|||
|
" familiarize yourself with all [server delegation (redirection) options"
|
|||
|
"](howto-server-delegation.md)."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:110
|
|||
|
msgid ""
|
|||
|
"To have the base domain served from the integrated web server, add the "
|
|||
|
"following configuration to your "
|
|||
|
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:116
|
|||
|
msgid "After configuring the playbook, run the command below:"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:122
|
|||
|
msgid "Things to do next"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:124
|
|||
|
msgid "After finilizing the installation, you can:"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:126
|
|||
|
msgid "[check if services work](maintenance-checking-services.md)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:127
|
|||
|
msgid ""
|
|||
|
"or [set up additional services](configuring-playbook.md#other-"
|
|||
|
"configuration-options) (bridges to other chat networks, bots, etc.)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:128
|
|||
|
msgid ""
|
|||
|
"or learn how to [upgrade services when new versions are released"
|
|||
|
"](maintenance-upgrading-services.md)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:129
|
|||
|
msgid "or learn how to [maintain your server](faq.md#maintenance)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:130
|
|||
|
msgid "or join some Matrix rooms:"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:131
|
|||
|
msgid ""
|
|||
|
"via the *Explore rooms* feature in Element Web or some other clients, or "
|
|||
|
"by discovering them using this [matrix-static "
|
|||
|
"list](https://view.matrix.org). **Note**: joining large rooms may "
|
|||
|
"overload small servers."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:132
|
|||
|
msgid ""
|
|||
|
"or come say Hi in our support room - [#matrix-docker-ansible-"
|
|||
|
"deploy:devture.com](https://matrix.to/#/#matrix-docker-ansible-"
|
|||
|
"deploy:devture.com). You might learn something or get to help someone "
|
|||
|
"else new to Matrix hosting."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:133
|
|||
|
msgid ""
|
|||
|
"or help make this playbook better by contributing (code, documentation, "
|
|||
|
"or [coffee/beer](https://liberapay.com/s.pantaleev/donate))"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:135
|
|||
|
msgid "Maintaining your setup in the future"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:137
|
|||
|
msgid ""
|
|||
|
"While this playbook helps you to set up Matrix services and maintain "
|
|||
|
"them, it will **not** automatically run the maintenance task for you. You"
|
|||
|
" will need to update the playbook and re-run it **manually**."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:139
|
|||
|
msgid ""
|
|||
|
"The upstream projects, which this playbook makes use of, occasionally if "
|
|||
|
"not often suffer from security vulnerabilities."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:141
|
|||
|
msgid ""
|
|||
|
"Since it is unsafe to keep outdated services running on the server "
|
|||
|
"connected to the internet, please consider to update the playbook and re-"
|
|||
|
"run it periodically, in order to keep the services up-to-date."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:143
|
|||
|
msgid ""
|
|||
|
"For more information about upgrading or maintaining services with the "
|
|||
|
"playbook, take at look at this page: [Upgrading the Matrix services"
|
|||
|
"](maintenance-upgrading-services.md)"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:145
|
|||
|
msgid ""
|
|||
|
"Feel free to **re-run the setup command any time** you think something is"
|
|||
|
" wrong with the server configuration. Ansible will take your "
|
|||
|
"configuration and update your server to match."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:151
|
|||
|
msgid ""
|
|||
|
"**Note**: see [this page on the playbook tags](playbook-tags.md) for more"
|
|||
|
" information about those tags."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:153
|
|||
|
msgid "Make full use of `just` shortcut commands"
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:155
|
|||
|
msgid ""
|
|||
|
"After you get familiar with reconfiguring and re-running the playbook to "
|
|||
|
"maintain the server, upgrade its services, etc., you probably would like "
|
|||
|
"to make use of `just` shortcut commands for faster input."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:157
|
|||
|
msgid ""
|
|||
|
"For example, `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."
|
|||
|
msgstr ""
|
|||
|
|
|||
|
#: ../../../docs/installing.md:159
|
|||
|
msgid ""
|
|||
|
"You can learn about the shortcut commands on this page: [Running `just` "
|
|||
|
"commands](just.md)"
|
|||
|
msgstr ""
|
|||
|
|