1
0
mirror of https://github.com/element-hq/element-web.git synced 2026-10-24 23:19:26 +03:00
Files
Patrick Maier b2dd6d57e3 Add a note that restricted-guests requires knocking to be enabled (#34729)
* Update README.md

* Update README.md

* Update modules/restricted-guests/README.md

Co-authored-by: R Midhun Suresh <hi@midhun.dev>

---------

Co-authored-by: R Midhun Suresh <hi@midhun.dev>
2026-10-03 10:37:32 +00:00

2.4 KiB

@element-hq/element-web-module-restricted-guests

Restricted Guests module for Element Web.

Supports the following configuration options under the configuration key io.element.element-web-modules.restricted-guests:

Key Type Description
guest_user_homeserver_url string URL of the homeserver on which to register the guest, must be running the synapse module.
guest_user_prefix string Prefix to apply to all guests registered via the module, defaults to @guest-.
skip_single_sign_on boolean If true, the user will be forwarded to the login page instead of to the SSO login. This is only required if the home server has no SSO support.

Knocking ("ask to join") has to be enabled

In order to make the feature work, knocking has to be enabled via config.json

"features": {
  "feature_ask_to_join": true
}

If you want to make it more obvious to users how to copy the link, you can modify the link a user gets from "Copy link" in the right sidebar by using permalink_prefix in config.json. If you don't do that, users will have to copy the URL from the address bar.

Copyright (c) 2025 New Vector Ltd

This software is multi licensed by New Vector Ltd (Element). It can be used either:

(1) for free under the terms of the GNU Affero General Public License (as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version); OR

(2) under the terms of a paid-for Element Commercial License agreement between you and Element (the terms of which may vary depending on what you and Element have agreed to). Unless required by applicable law or agreed to in writing, software distributed under the Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the Licenses for the specific language governing permissions and limitations under the Licenses.