# 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 , 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 \n" "Language: jp\n" "Language-Team: jp \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 "" "[Prerequisites](prerequisites.md) > [Configuring your DNS settings" "](configuring-dns.md) > [Getting the playbook](getting-the-playbook.md) >" " [Configuring the playbook](configuring-playbook.md) > Installing" 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 ""