# SOME DESCRIPTIVE TITLE. # Copyright (C) 2018-2025, Slavi Pantaleev, Aine Etke, MDAD community members # This file is distributed under the same license as the matrix-docker-ansible-deploy package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-01-27 09:54+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../../../docs/configuring-playbook-conduwuit.md:1 msgid "Configuring conduwuit (optional)" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:3 msgid "The playbook can install and configure the [conduwuit](https://conduwuit.puppyirl.gay/) Matrix server for you." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:5 msgid "See the project's [documentation](https://conduwuit.puppyirl.gay/) to learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:7 msgid "By default, the playbook installs [Synapse](https://github.com/element-hq/synapse) as it's the only full-featured Matrix server at the moment. If that's okay, you can skip this document." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:9 msgid "💡 **Note**: conduwuit is a fork of [Conduit](./configuring-playbook-conduit.md), which the playbook also supports. See [Differences from upstream Conduit](https://conduwuit.puppyirl.gay/differences.html)." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:11 msgid "⚠️ **Warnings**:" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:13 msgid "**You can't switch an existing Matrix server's implementation** (e.g. Synapse -> conduwuit). Proceed below only if you're OK with losing data or you're dealing with a server on a new domain name, which hasn't participated in the Matrix federation yet." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:15 msgid "**Homeserver implementations other than Synapse may not be fully functional**. The playbook may also not assist you in an optimal way (like it does with Synapse). Make yourself familiar with the downsides before proceeding" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:17 msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:19 msgid "To use conduwuit, you **generally** need to adjust the `matrix_homeserver_implementation: synapse` configuration on your `inventory/host_vars/matrix.example.com/vars.yml` file as below:" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:33 msgid "Extending the configuration" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:35 msgid "There are some additional things you may wish to configure about the server." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:37 msgid "Take a look at:" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:39 msgid "`roles/custom/matrix-conduwuit/defaults/main.yml` for some variables that you can customize via your `vars.yml` file" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:40 msgid "`roles/custom/matrix-conduwuit/templates/conduwuit.toml.j2` for the server's default configuration" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:42 msgid "There are various Ansible variables that control settings in the `conduwuit.toml` file." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:44 msgid "If a specific setting you'd like to change does not have a dedicated Ansible variable, you can either submit a PR to us to add it, or you can [override the setting using an environment variable](https://conduwuit.puppyirl.gay/configuration.html#environment-variables) using `matrix_conduwuit_environment_variables_extension`. For example:" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:52 msgid "Creating the first user account" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:54 msgid "Unlike other homeserver implementations (like Synapse and Dendrite), conduwuit does not support creating users via the command line or via the playbook." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:56 msgid "If you followed the instructions above (see [Adjusting the playbook configuration](#adjusting-the-playbook-configuration)), you should have registration enabled and protected by a registration token." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:58 msgid "This should allow you to create the first user account via any client (like [Element Web](./configuring-playbook-client-element-web.md)) which supports creating users." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:60 msgid "The **first user account that you create will be marked as an admin** and **will be automatically invited to an admin room**." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:63 msgid "Configuring bridges / appservices" msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:65 msgid "For other homeserver implementations (like Synapse and Dendrite), the playbook automatically registers appservices (for bridges, bots, etc.) with the homeserver." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:67 msgid "For conduwuit, you will have to manually register appservices using the [`!admin appservices register` command](https://conduwuit.puppyirl.gay/appservices.html#set-up-the-appservice---general-instructions) sent to the server bot account." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:69 msgid "The server's bot account has a Matrix ID of `@conduit:example.com` (not `@conduwuit:example.com`!) due to conduwuit's historical legacy. Your first user account would already have been invited to an admin room with this bot." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:72 msgid "Find the appservice file you'd like to register. This can be any `registration.yaml` file found in the `/matrix` directory, for example `/matrix/mautrix-signal/bridge/registration.yaml`." msgstr "" #: ../../../docs/configuring-playbook-conduwuit.md:74 msgid "Then, send its content to the existing admin room:" msgstr ""