mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2026-04-04 13:46:59 +03:00
9049a82945
* 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>
239 lines
11 KiB
Plaintext
239 lines
11 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2018-2026, 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>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|
"Report-Msgid-Bugs-To: \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"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../../../docs/registering-users.md:11
|
|
msgid "Registering users"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:13
|
|
msgid "This documentation page tells you how to create user accounts on your Matrix server."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:15
|
|
msgid "Table of contents:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:16
|
|
msgid "[Registering users](#registering-users)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:17
|
|
msgid "[Registering users manually](#registering-users-manually)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:18
|
|
msgid "[Managing users via a Web UI](#managing-users-via-a-web-ui)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:19
|
|
msgid "[Letting certain users register on your private server](#letting-certain-users-register-on-your-private-server)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:20
|
|
msgid "[Enabling public user registration](#enabling-public-user-registration)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:21
|
|
msgid "[Adding/Removing Administrator privileges to an existing user](#addingremoving-administrator-privileges-to-an-existing-user)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:23
|
|
msgid "Registering users manually"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:25
|
|
#: ../../../docs/registering-users.md:127
|
|
msgid "**Notes**:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:26
|
|
msgid "Make sure to adjust `USERNAME_HERE` and `PASSWORD_HERE`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:27
|
|
msgid "For `USERNAME_HERE`, use a plain username like `alice`, not a full ID (`@alice:example.com`)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:28
|
|
msgid "Use `admin=yes` or `admin=no` depending on whether you wish to make the user an administrator of the Matrix server"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:30
|
|
msgid "After registering a user (using one of the methods below), **you can log in with that user** via the [Element Web](configuring-playbook-client-element-web.md) service that this playbook has installed for you at a URL like this: `https://element.example.com/`."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:32
|
|
msgid "Registering users via the Ansible playbook"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:34
|
|
msgid "It's best to register users via the Ansible playbook, because it works regardless of homeserver implementation (Synapse, Dendrite, etc) or usage of [Matrix Authentication Service](configuring-playbook-matrix-authentication-service.md) (MAS)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:36
|
|
msgid "To register a user via this Ansible playbook:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:44
|
|
msgid "**or** by invoking `ansible-playbook` manually:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:52
|
|
msgid "Feel free to register as many users (for friends, family, etc.) as you want. Still, perhaps you should grant full administrative access to your user account only (with `admin=yes`), and others should be created with `admin=no`."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:54
|
|
msgid "[!WARNING] If you're registering users against Matrix Authentication Service, do note that it [still insists](https://github.com/element-hq/matrix-authentication-service/issues/1505) on having a verified email address for each user. Upon a user's first login, they will be asked to confirm their email address. This requires that email sending is [configured](./configuring-playbook-email.md). You can also consult the [Working around email deliverability issues](./configuring-playbook-matrix-authentication-service.md#working-around-email-deliverability-issues) section for more information."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:57
|
|
msgid "Registering users manually for Synapse"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:59
|
|
msgid "If you're using the [Synapse](configuring-playbook-synapse.md) homeserver implementation (which is the default), you can register users via the command-line after **SSH**-ing to your server (requires that [all services have been started](installing.md#install-matrix-server-and-services)):"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:67
|
|
msgid "Registering users manually for Dendrite"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:69
|
|
msgid "If you're using the [Dendrite](./configuring-playbook-dendrite.md) homeserver implementation, you can register users via the command-line after **SSH**-ing to your server (requires that [all services have been started](installing.md#install-matrix-server-and-services)):"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:77
|
|
msgid "Registering users manually for Matrix Authentication Service"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:79
|
|
msgid "If you're using the [Matrix Authentication Service](./configuring-playbook-matrix-authentication-service.md) and your existing homeserver (most likely [Synapse](./configuring-playbook-synapse.md)) is delegating authentication to it, you can register users via the command-line after **SSH**-ing to your server (requires that [all services have been started](installing.md#install-matrix-server-and-services)):"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:87
|
|
msgid "This `register-user` script actually invokes the `mas-cli manage register-user` command under the hood. If you'd like more control over the registration process, consider invoking the `mas-cli` command directly:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:93
|
|
msgid "[!WARNING] Matrix Authentication Service [still insists](https://github.com/element-hq/matrix-authentication-service/issues/1505) on having a verified email address for each user. Upon a user's first login, they will be asked to confirm their email address. This requires that email sending is [configured](./configuring-playbook-email.md). You can also consult the [Working around email deliverability issues](./configuring-playbook-matrix-authentication-service.md#working-around-email-deliverability-issues) section for more information."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:96
|
|
msgid "Managing users via a Web UI"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:98
|
|
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 "Letting certain users register on your private server"
|
|
msgstr ""
|
|
|
|
#: ../../../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:104
|
|
msgid "Enabling public user registration"
|
|
msgstr ""
|
|
|
|
#: ../../../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:108
|
|
msgid "For Synapse:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:114
|
|
msgid "For Dendrite:"
|
|
msgstr ""
|
|
|
|
#: ../../../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: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: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: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:135
|
|
msgid "Adding/Removing Administrator privileges to an existing user"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:137
|
|
msgid "Adding/Removing Administrator privileges to an existing user in Synapse"
|
|
msgstr ""
|
|
|
|
#: ../../../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:145
|
|
msgid "where:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:147
|
|
msgid "`ADMIN_VALUE` being either `0` (regular user) or `1` (admin)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:148
|
|
msgid "`USER` and `example.com` pointing to a valid user on your server"
|
|
msgstr ""
|
|
|
|
#: ../../../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:152
|
|
msgid "running `/matrix/postgres/bin/cli` — to launch [`psql`](https://www.postgresql.org/docs/current/app-psql.html)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:153
|
|
msgid "running `\\c synapse` — to change to the `synapse` database"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/registering-users.md:155
|
|
msgid "You can then proceed to run the query above."
|
|
msgstr ""
|
|
|
|
#: ../../../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:159
|
|
msgid "Adding/Removing Administrator privileges to an existing user in Matrix Authentication Service"
|
|
msgstr ""
|
|
|
|
#: ../../../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: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 ""
|