synapse_ynh/config_panel.toml

version = "1.0"

[homeserver]
name = "Homeserver Privacy"
services = ["__APP__"]

    [homeserver.config]
    name = "Configuration Options"

            [homeserver.config.backup_before_upgrade]
            ask = "Backup before upgrade"
            type = "boolean"
            yes = true
            no = false
            help = "Set to 'true' to backup the Synapse YunoHost App before each upgrade."

            [homeserver.config.server_statistics]
            ask = "Server statistics"
            type = "boolean"
            yes = true
            no = false
            help = "Set to 'true' to send anonymous statistics to Synapse to improve performance."
            bind = "report_stats:/etc/matrix-__APP__/homeserver.yaml"

    [homeserver.privacy]
    name = "Data Privacy"

            [homeserver.privacy.default_identity_server]
            ask = "Identity server suggested to clients."
            type = "url"
            help = "By default, no suggestion is made, so it is left up to the client."
            bind = ":/etc/matrix-__APP__/homeserver.yaml"

            [homeserver.privacy.allow_public_rooms_without_auth]
            ask = "Public rooms directory"
            type = "boolean"
            yes = true
            no = false
            help = "If set to 'false', requires authentication to access the server's public rooms directory through the client API and forbids any other homeserver to fetch the server's public rooms directory via federation."
            bind = ":/etc/matrix-__APP__/homeserver.yaml"

            [homeserver.privacy.allow_public_rooms_over_federation]
            ask = "Public rooms directory"
            type = "boolean"
            yes = true
            no = false
            help = "If set to 'false', requires authentication to access the server's public rooms directory through the client API and forbids any other homeserver to fetch the server's public rooms directory via federation."
            bind = ":/etc/matrix-__APP__/homeserver.yaml"

[account]
name = "Registration"
services = ["__APP__"]

    [account.registration]
    name = "Account Registration"

            [account.registration.turn_allow_guests]
            ask = "Should guests be allowed to use the TURN server?"
            type = "boolean"
            yes = true
            no = false
            help = "This defaults to True, otherwise VoIP will be unreliable for guests. However, it does introduce a slight security risk as it allows users to connect to arbitrary endpoints without having first signed up for a valid account (e.g. by passing a CAPTCHA)."
            bind = ":/etc/matrix-__APP__/homeserver.yaml"

            [account.registration.enable_registration]
            ask = "Enable Registration for new users."
            type = "boolean"
            yes = true
            no = false
            help = "Defaults to 'false'. If 'true', it is highly recommended to use either captcha, email, or token-based verification to avoid SPAM."
            bind = ":/etc/matrix-__APP__/homeserver.yaml"

            [account.registration.registrations_require_3pid]
            ask = "Register only with all below types of 3PID."
            type = "string"
            help = "Defaults to: '- email'. Phone number: '- msisdn'"
            bind = ":/etc/matrix-__APP__/homeserver.yaml"

            [account.registration.disable_msisdn_registration]
            ask = "Disable asking Phone Number in Registration flow."
            type = "boolean"
            yes = true
            no = false
            help = "Overrides above setting if MSISDNs are set as required."
            bind = ":/etc/matrix-__APP__/homeserver.yaml"

            [account.registration.allowed_local_3pids]
            ask = "Register only with given formats of 3PIDs."
            type = "string"
            help = '''
            allowed_local_3pids:
              - medium: email            - medium: email
                pattern: '^[^@]+@matrix\.org$'
              - medium: msisdn
                pattern: '\+33'
            '''

            [account.registration.registration_shared_secret]
            ask = "Shared Secret for Registration."
            type = "string"
            help = "Allows registration of standard or admin accounts, even if Registration disabled."
            bind = ":/etc/matrix-__APP__/homeserver.yaml"

            [account.registration.allow_guest_access]
            ask = "Allow Users to Register as Guests?"
            type = "boolean"
            yes = true
            no = false
            help = "Guests can participate on this server in rooms with guest access enabled, without a password/email/etc."
            bind = ":/etc/matrix-__APP__/homeserver.yaml"

[client]
name = "Matrix Client"
services = ["__APP__"]

    [client.experience]
    name = "User Experience"

        [client.experience.max_upload_size]
        ask = "Largest allowed media upload size in bytes."
        type = "url"
        help = "Defaults to: '10M' . If you are using a reverse proxy you may also need to set this value in your reverse proxy's config. Notably Nginx has a small max body size by default. See https://matrix-org.github.io/synapse/latest/reverse_proxy.html."
        bind = ":/etc/matrix-__APP__/homeserver.yaml"

        [client.experience.web_client_location]
        ask = "URL to the web client which / will redirect to."
        type = "url"
        help = "Basically Element instance the server should redirect to."
        bind = ":/etc/matrix-__APP__/homeserver.yaml"

        [client.experience.client_base_url]
        ask = "URL for client links within the email notifications."
        type = "url"
        help = "Used to be called 'riot_base_url', still supported"
        bind = ":/etc/matrix-__APP__/homeserver.yaml"

        [client.experience.invite_client_location]
        ask = "Web client location to direct users to during an invite."
        type = "url"
        help = "This is passed to the identity server as the org.matrix.web_client_location key. Defaults to unset, giving no guidance to the identity server."
        bind = ":/etc/matrix-__APP__/homeserver.yaml"

        [client.experience.enable_group_creation]
        ask = "Allow non-server-admin Users to create Spaces?"
        type = "boolean"
        yes = true
        no = false
        help = "Defaults to 'false'."
        bind = ":/etc/matrix-__APP__/homeserver.yaml"

        [client.experience.e2e_enabled_by_default]
        ask = "End-to-End Encryption by default for locally-created Rooms"
        type = "select"
        choices = ["all", "invite", "off"]
        help = '''
        * "all": any locally-created room
        * "invite": any room created with the "private_chat" or "trusted_private_chat" room creation presets
        * "off": this option will take no effect
        '''
        bind = "encryption_enabled_by_default_for_room_type:/etc/matrix-__APP__/homeserver.yaml"

    [client.welcome]
    name = "Welcome User Experience"

        [client.welcome.auto_join_rooms]
        ask = "Auto Join new Users in following Rooms."
        type = "string"
        help = "Room should be public. If not existing, will be created as public and federated by default."
        bind = ":/etc/matrix-__APP__/homeserver.yaml"

        [client.welcome.autocreate_auto_join_rooms]
        ask = "Create room for Auto Join if not existing."
        type = "boolean"
        yes = true
        no = false
        help = "Will be created as public and federated by default. Can be customised with the settings auto_join_*."
        bind = ":/etc/matrix-__APP__/homeserver.yaml"

        [client.welcome.auto_join_rooms_for_guests]
        ask = "Enable Auto Join Room for Guests?"
        type = "boolean"
        yes = true
        no = false
        help = "Defaults to 'true'."
        bind = ":/etc/matrix-__APP__/homeserver.yaml"

        [client.welcome.password_enabled]
        ask = "Enable Password Login?"
        type = "boolean"
        yes = true
        no = false
        help = "Defaults to 'true'."
        bind = "password_config>enabled:/etc/matrix-__APP__/homeserver.yaml"

        [client.welcome.enable_notifs]
        ask = "Enable sending emails for messages the user missed?"
        type = "boolean"
        yes = true
        no = false
        help = "Defaults to 'false'."
        bind = ":/etc/matrix-__APP__/homeserver.yaml"

        [client.welcome.notif_for_new_users]
        ask = "Enable email notifications for new users?"
        type = "boolean"
        yes = true
        no = false
        help = "Defaults to 'true'."
        bind = ":/etc/matrix-__APP__/homeserver.yaml"