overmind
/
matrix-docker-ansible-deploy
peilaus alkaen https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Fork 0
Koodi Ongelmat 0 Julkaisut 0 Wiki Toiminta
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.
10803 Commitit
12 Branchit
241 MiB
 
 
Puu: d99ec94e14
Branchit Tagit
${ item.name }
Create branch ${ searchTerm }
from 'd99ec94e14'
${ noResults }
matrix-docker-ansible-deploy/i18n/translation-templates/docs/configuring-playbook-conduw...

142 rivejä
6.9 KiB
Raaka Blame Historia 

  1. # SOME DESCRIPTIVE TITLE.

  2. # Copyright (C) 2018-2025, Slavi Pantaleev, Aine Etke, MDAD community members

  3. # This file is distributed under the same license as the matrix-docker-ansible-deploy package.

  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

  5. #

  6. #, fuzzy

  7. msgid ""

  8. msgstr ""

  9. "Project-Id-Version: matrix-docker-ansible-deploy \n"

  10. "Report-Msgid-Bugs-To: \n"

  11. "POT-Creation-Date: 2025-11-06 23:09+0900\n"

  12. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"

  13. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"

  14. "Language-Team: LANGUAGE <LL@li.org>\n"

  15. "MIME-Version: 1.0\n"

  16. "Content-Type: text/plain; charset=UTF-8\n"

  17. "Content-Transfer-Encoding: 8bit\n"

  18. 

  19. #: ../../../docs/configuring-playbook-conduwuit.md:8

  20. msgid "Configuring conduwuit (optional)"

  21. msgstr ""

  22. 

  23. #: ../../../docs/configuring-playbook-conduwuit.md:10

  24. msgid "The playbook can install and configure the [conduwuit](https://conduwuit.puppyirl.gay/) Matrix server for you."

  25. msgstr ""

  26. 

  27. #: ../../../docs/configuring-playbook-conduwuit.md:12

  28. msgid "See the project's [documentation](https://conduwuit.puppyirl.gay/) to learn what it does and why it might be useful to you."

  29. msgstr ""

  30. 

  31. #: ../../../docs/configuring-playbook-conduwuit.md:14

  32. 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."

  33. msgstr ""

  34. 

  35. #: ../../../docs/configuring-playbook-conduwuit.md:16

  36. 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)."

  37. msgstr ""

  38. 

  39. #: ../../../docs/configuring-playbook-conduwuit.md:18

  40. msgid "[!WARNING]"

  41. msgstr ""

  42. 

  43. #: ../../../docs/configuring-playbook-conduwuit.md:19

  44. 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."

  45. msgstr ""

  46. 

  47. #: ../../../docs/configuring-playbook-conduwuit.md:20

  48. 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"

  49. msgstr ""

  50. 

  51. #: ../../../docs/configuring-playbook-conduwuit.md:21

  52. msgid "**the Conduwuit project appears to have been abandoned**. You may wish to install [Conduit](./configuring-playbook-conduit.md), or one of the Conduwuit successors (like [Continuwuity](configuring-playbook-continuwuity.md))"

  53. msgstr ""

  54. 

  55. #: ../../../docs/configuring-playbook-conduwuit.md:23

  56. msgid "Adjusting the playbook configuration"

  57. msgstr ""

  58. 

  59. #: ../../../docs/configuring-playbook-conduwuit.md:25

  60. 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:"

  61. msgstr ""

  62. 

  63. #: ../../../docs/configuring-playbook-conduwuit.md:39

  64. msgid "Extending the configuration"

  65. msgstr ""

  66. 

  67. #: ../../../docs/configuring-playbook-conduwuit.md:41

  68. msgid "There are some additional things you may wish to configure about the server."

  69. msgstr ""

  70. 

  71. #: ../../../docs/configuring-playbook-conduwuit.md:43

  72. msgid "Take a look at:"

  73. msgstr ""

  74. 

  75. #: ../../../docs/configuring-playbook-conduwuit.md:45

  76. msgid "`roles/custom/matrix-conduwuit/defaults/main.yml` for some variables that you can customize via your `vars.yml` file"

  77. msgstr ""

  78. 

  79. #: ../../../docs/configuring-playbook-conduwuit.md:46

  80. msgid "`roles/custom/matrix-conduwuit/templates/conduwuit.toml.j2` for the server's default configuration"

  81. msgstr ""

  82. 

  83. #: ../../../docs/configuring-playbook-conduwuit.md:48

  84. msgid "There are various Ansible variables that control settings in the `conduwuit.toml` file."

  85. msgstr ""

  86. 

  87. #: ../../../docs/configuring-playbook-conduwuit.md:50

  88. 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:"

  89. msgstr ""

  90. 

  91. #: ../../../docs/configuring-playbook-conduwuit.md:58

  92. msgid "Creating the first user account"

  93. msgstr ""

  94. 

  95. #: ../../../docs/configuring-playbook-conduwuit.md:60

  96. msgid "Unlike other homeserver implementations (like Synapse and Dendrite), conduwuit does not support creating users via the command line or via the playbook."

  97. msgstr ""

  98. 

  99. #: ../../../docs/configuring-playbook-conduwuit.md:62

  100. 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."

  101. msgstr ""

  102. 

  103. #: ../../../docs/configuring-playbook-conduwuit.md:64

  104. 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."

  105. msgstr ""

  106. 

  107. #: ../../../docs/configuring-playbook-conduwuit.md:66

  108. msgid "The **first user account that you create will be marked as an admin** and **will be automatically invited to an admin room**."

  109. msgstr ""

  110. 

  111. #: ../../../docs/configuring-playbook-conduwuit.md:69

  112. msgid "Configuring bridges / appservices"

  113. msgstr ""

  114. 

  115. #: ../../../docs/configuring-playbook-conduwuit.md:71

  116. msgid "For other homeserver implementations (like Synapse and Dendrite), the playbook automatically registers appservices (for bridges, bots, etc.) with the homeserver."

  117. msgstr ""

  118. 

  119. #: ../../../docs/configuring-playbook-conduwuit.md:73

  120. 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."

  121. msgstr ""

  122. 

  123. #: ../../../docs/configuring-playbook-conduwuit.md:75

  124. 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."

  125. msgstr ""

  126. 

  127. #: ../../../docs/configuring-playbook-conduwuit.md:78

  128. 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`."

  129. msgstr ""

  130. 

  131. #: ../../../docs/configuring-playbook-conduwuit.md:80

  132. msgid "Then, send its content to the existing admin room:"

  133. msgstr ""

  134. 

  135. #: ../../../docs/configuring-playbook-conduwuit.md:104

  136. msgid "Troubleshooting"

  137. msgstr ""

  138. 

  139. #: ../../../docs/configuring-playbook-conduwuit.md:106

  140. msgid "As with all other services, you can find the logs in [systemd-journald](https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html) by logging in to the server with SSH and running `journalctl -fu matrix-conduwuit`."

  141. msgstr ""