Synapse Admin is Ketesa now! (#5113)

* Synapse Admin is Ketesa now!

* i18n changes

* add automatic migration

* fix migration version in vars

* add a note about routing for OIDC Auth

* mention v1.0.0 announcement blog post

* Update docs/container-images.md

Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com>

* Update CHANGELOG.md

Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com>

---------

Co-authored-by: Suguru Hirahara <luixxiul@users.noreply.github.com>
This commit is contained in:
Aine
2026-04-03 15:26:18 +01:00
committed by GitHub
parent 3d40026f93
commit 9049a82945
100 changed files with 19316 additions and 15130 deletions
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: matrix-docker-ansible-deploy \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-02-13 10:32+0000\n"
"POT-Creation-Date: 2026-04-03 11:56+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -57,7 +57,7 @@ msgid "Registering users manually"
msgstr ""
#: ../../../docs/registering-users.md:25
#: ../../../docs/registering-users.md:130
#: ../../../docs/registering-users.md:127
msgid "**Notes**:"
msgstr ""
@@ -138,105 +138,101 @@ msgid "Managing users via a Web UI"
msgstr ""
#: ../../../docs/registering-users.md:98
msgid "To manage users more easily (via a web user-interace), you can install [Synapse Admin](configuring-playbook-synapse-admin.md)."
msgid "To manage users and your homeserver more easily (via a web interface), you can install [Ketesa](configuring-playbook-ketesa.md) — a fully-featured admin UI covering users, rooms, media, sessions, and MAS management."
msgstr ""
#: ../../../docs/registering-users.md:100
msgid "[!WARNING] If you're using [Matrix Authentication Service](configuring-playbook-matrix-authentication-service.md), note that user management via synapse-admin is not fully working yet. See the [Expectations](configuring-playbook-matrix-authentication-service.md#expectations) section for more information."
msgstr ""
#: ../../../docs/registering-users.md:103
msgid "Letting certain users register on your private server"
msgstr ""
#: ../../../docs/registering-users.md:105
#: ../../../docs/registering-users.md:102
msgid "If you'd rather **keep your server private** (public registration closed, as is the default), and **let certain people create accounts by themselves** (instead of creating user accounts manually like this), consider installing and making use of [matrix-registration](configuring-playbook-matrix-registration.md)."
msgstr ""
#: ../../../docs/registering-users.md:107
#: ../../../docs/registering-users.md:104
msgid "Enabling public user registration"
msgstr ""
#: ../../../docs/registering-users.md:109
#: ../../../docs/registering-users.md:106
msgid "To **open up user registration publicly** (usually **not recommended**), add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/registering-users.md:111
#: ../../../docs/registering-users.md:108
msgid "For Synapse:"
msgstr ""
#: ../../../docs/registering-users.md:117
#: ../../../docs/registering-users.md:114
msgid "For Dendrite:"
msgstr ""
#: ../../../docs/registering-users.md:123
#: ../../../docs/registering-users.md:120
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/registering-users.md:132
#: ../../../docs/registering-users.md:129
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/registering-users.md:134
#: ../../../docs/registering-users.md:131
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/registering-users.md:136
#: ../../../docs/registering-users.md:133
msgid "If you're opening up registrations publicly like this, you might also wish to [configure CAPTCHA protection](configuring-captcha.md)."
msgstr ""
#: ../../../docs/registering-users.md:138
#: ../../../docs/registering-users.md:135
msgid "Adding/Removing Administrator privileges to an existing user"
msgstr ""
#: ../../../docs/registering-users.md:140
#: ../../../docs/registering-users.md:137
msgid "Adding/Removing Administrator privileges to an existing user in Synapse"
msgstr ""
#: ../../../docs/registering-users.md:142
#: ../../../docs/registering-users.md:139
msgid "To change the admin privileges for a user in Synapse's local database, you need to run an SQL query like this against the `synapse` database:"
msgstr ""
#: ../../../docs/registering-users.md:148
#: ../../../docs/registering-users.md:145
msgid "where:"
msgstr ""
#: ../../../docs/registering-users.md:150
#: ../../../docs/registering-users.md:147
msgid "`ADMIN_VALUE` being either `0` (regular user) or `1` (admin)"
msgstr ""
#: ../../../docs/registering-users.md:151
#: ../../../docs/registering-users.md:148
msgid "`USER` and `example.com` pointing to a valid user on your server"
msgstr ""
#: ../../../docs/registering-users.md:153
#: ../../../docs/registering-users.md:150
msgid "If you're using the integrated Postgres server and not an [external Postgres server](configuring-playbook-external-postgres.md), you can launch a Postgres into the `synapse` database by:"
msgstr ""
#: ../../../docs/registering-users.md:155
#: ../../../docs/registering-users.md:152
msgid "running `/matrix/postgres/bin/cli` — to launch [`psql`](https://www.postgresql.org/docs/current/app-psql.html)"
msgstr ""
#: ../../../docs/registering-users.md:156
#: ../../../docs/registering-users.md:153
msgid "running `\\c synapse` — to change to the `synapse` database"
msgstr ""
#: ../../../docs/registering-users.md:158
#: ../../../docs/registering-users.md:155
msgid "You can then proceed to run the query above."
msgstr ""
#: ../../../docs/registering-users.md:160
#: ../../../docs/registering-users.md:157
msgid "**Note**: directly modifying the raw data of Synapse (or any other software) could cause the software to break. You've been warned!"
msgstr ""
#: ../../../docs/registering-users.md:162
#: ../../../docs/registering-users.md:159
msgid "Adding/Removing Administrator privileges to an existing user in Matrix Authentication Service"
msgstr ""
#: ../../../docs/registering-users.md:164
#: ../../../docs/registering-users.md:161
msgid "Promoting/demoting a user in Matrix Authentication Service can be done using the [`mas-cli`](./configuring-playbook-matrix-authentication-service.md#management) management tool's [`manage promote-admin`](https://element-hq.github.io/matrix-authentication-service/reference/cli/manage.html#manage-promote-admin) and [`manage demote-admin`](https://element-hq.github.io/matrix-authentication-service/reference/cli/manage.html#manage-demote-admin) commands. For example: `/matrix/matrix-authentication-service/bin/mas-cli manage promote-admin some.username`."
msgstr ""
#: ../../../docs/registering-users.md:166
#: ../../../docs/registering-users.md:163
msgid "You can also do it via the [MAS Admin API](https://element-hq.github.io/matrix-authentication-service/api/index.html)'s `POST /api/admin/v1/users/{id}/set-admin` endpoint."
msgstr ""