2022-11-24 19:48:16 +01:00
version = "1.0"
2023-01-06 01:26:44 +01:00
[ appservice ]
2023-01-06 10:58:58 +01:00
name = "Homeserver Application Service"
2022-12-14 22:30:47 +01:00
services = [ "__APP__" ]
2023-01-06 01:26:44 +01:00
[ appservice . config ]
2023-01-06 10:58:58 +01:00
name = "Appservice Settings"
2023-01-06 01:26:44 +01:00
[ appservice . config . ephemeral_events ]
2023-01-06 10:58:58 +01:00
ask = "Receive Ephemeral Events via Appservice transactions?"
2023-01-06 01:26:44 +01:00
type = "boolean"
yes = "true"
no = "false"
help = "Requires MSC2409 support (i.e. Synapse 1.22+). You should disable bridge -> sync_with_custom_puppets when this is enabled"
bind = ":__FINALPATH__/config.yaml"
[ appservice . config . print_level ]
ask = "Root logging print level"
type = "select"
2023-01-06 10:20:02 +01:00
choices = [ "DEBUG" , "INFO" , "WARNING" , "ERROR" , "CRITICAL" , "NOTSET" ]
2023-01-06 01:26:44 +01:00
help = "NOTSET means that all messages will be logged: https://docs.python.org/3.6/library/logging.config.html#configuration-file-format"
2023-01-08 21:50:52 +01:00
bind = "root>level:__FINALPATH__/config.yaml"
2023-01-06 01:26:44 +01:00
[ appservice . bot ]
2023-01-06 10:58:58 +01:00
name = "Robot Settings"
2023-01-06 01:26:44 +01:00
[ appservice . bot . appserviceid ]
2023-01-06 10:58:58 +01:00
ask = "Unique ID of Appservice"
2023-01-06 01:26:44 +01:00
type = "string"
2023-01-08 21:50:52 +01:00
bind = "appservice>id:__FINALPATH__/config.yaml"
2023-01-06 01:26:44 +01:00
[ appservice . bot . botname ]
2023-01-06 10:58:58 +01:00
ask = "Username of the Appservice Bot"
2023-01-06 01:26:44 +01:00
type = "string"
help = "Sets bot username. Please keep in mind that the bot admin room for previous bot username will stop working so you may need to create a new one using the new username"
2023-01-08 21:50:52 +01:00
bind = "appservice>bot_username:__FINALPATH__/config.yaml"
2023-01-06 01:26:44 +01:00
[ appservice . bot . displayname ]
2023-01-06 10:58:58 +01:00
ask = "Display Name for Bot"
2023-01-06 01:26:44 +01:00
type = "string"
help = "Set to 'remove' to remove display name, leave empty to leave display name as-is"
2023-01-08 21:50:52 +01:00
bind = "appservice>bot_displayname:__FINALPATH__/config.yaml"
2023-01-06 01:26:44 +01:00
[ appservice . bot . avatar ]
2023-01-06 10:58:58 +01:00
ask = "Avatar for Bot"
2023-01-06 01:26:44 +01:00
type = "string"
help = "Set to 'remove' to remove avatar, leave empty to leave avatar as-is"
2023-01-08 21:50:52 +01:00
bind = "appservice>bot_avatar:__FINALPATH__/config.yaml"
2023-01-06 01:26:44 +01:00
2023-01-06 11:26:28 +01:00
[ appservice . metrics ]
name = "Prometheus Metrics"
[ appservice . metrics . enable_metrics ]
ask = "Enable Prometheus Metrics?"
type = "boolean"
yes = "true"
no = "false"
2023-01-08 21:50:52 +01:00
bind = "metrics>enabled:__FINALPATH__/config.yaml"
2023-01-06 11:26:28 +01:00
2023-01-08 21:50:52 +01:00
[ appservice . metrics . listen_port ]
2023-01-06 11:26:28 +01:00
ask = "Port for the Metrics listener?"
type = "string"
help = "Default 8000."
bind = ":__FINALPATH__/config.yaml"
2023-01-06 10:58:58 +01:00
[ signald ]
name = "Signal Daemon Service"
services = [ "__APP__" ]
[ signald . config ]
name = "Signald Settings"
[ signald . config . registration_enabled ]
ask = "Can Bridge Users register as a primary device?"
type = "boolean"
yes = "true"
no = "false"
help = "If yes, you still need a phone number to register signald as you primary device. If not, you need a phone with Signal App."
bind = ":__FINALPATH__/config.yaml"
[ signald . config . enable_disappearing_messages_in_groups ]
ask = "Enable disappearing messages in groups?"
type = "boolean"
yes = "true"
no = "false"
help = "If the bridge has a single user, this can be turned on safely. If enabled, then the expiration time of the messages will be determined by the first users to read the message, rather than individually."
bind = ":__FINALPATH__/config.yaml"
2023-01-06 01:26:44 +01:00
[ bridge ]
name = "Bridge"
services = [ "__APP__" ]
2023-01-06 10:58:58 +01:00
2023-01-06 01:26:44 +01:00
[ bridge . config ]
2023-01-06 10:58:58 +01:00
name = "Puppet Settings"
2023-01-06 01:26:44 +01:00
[ bridge . config . username_template ]
ask = "Localpart template of MXIDs for Signal users."
type = "string"
help = "{userid} is replaced with an identifier for the Signal user."
bind = ":__FINALPATH__/config.yaml"
[ bridge . config . contact_list_names ]
2023-01-06 10:58:58 +01:00
ask = "Should contact list displaynames be used?"
2023-01-06 17:08:31 +01:00
type = "select"
2023-01-06 01:26:44 +01:00
choices = [ "disallow" , "allow" , "prefer" ]
help = "Multi-user instances are recommended to disallow contact list names, as otherwise there can be conflicts between names from different users' contact lists."
bind = ":__FINALPATH__/config.yaml"
2023-01-06 11:26:28 +01:00
[ bridge . config . enable_relaybot ]
ask = "Should Relay mode be allowed?"
type = "boolean"
yes = "true"
no = "false"
help = "If allowed, `!sg set-relay` can be used to turn any authenticated user into a RelayBot for that chat."
2023-01-10 11:33:10 +01:00
bind = "relay>enabled:__FINALPATH__/config.yaml"
2023-01-06 11:26:28 +01:00
2023-01-06 10:58:58 +01:00
[ bridge . portal_rooms ]
name = "Portal Rooms & Encryption Settings"
[ bridge . portal_rooms . federate_rooms ]
ask = "Should Portal Rooms have federation enabled?"
2022-11-30 22:12:08 +01:00
type = "boolean"
2022-12-14 22:30:47 +01:00
yes = "true"
no = "false"
2023-01-06 10:58:58 +01:00
help = "If false, Portal Rooms created by the Bridge will never be federated."
2023-01-06 01:26:44 +01:00
bind = ":__FINALPATH__/config.yaml"
2023-01-06 10:58:58 +01:00
[ bridge . portal_rooms . encryption ]
ask = "Allow End-to-Bridge (e2b) Encryption?"
2023-01-06 01:26:44 +01:00
type = "boolean"
yes = "true"
no = "false"
2023-01-06 10:58:58 +01:00
help = "For the Bridge to work in group chat Rooms with End-to-End Encryption (e2ee) enabled."
2023-01-08 21:50:52 +01:00
bind = "encryption>allow:__FINALPATH__/config.yaml"
2023-01-04 22:42:09 +01:00
2023-01-06 10:58:58 +01:00
[ bridge . portal_rooms . encryption_default ]
ask = "Force-enable Encryption in all Portal Rooms the Bridge creates?"
2023-01-04 22:42:09 +01:00
type = "boolean"
yes = "true"
no = "false"
2023-01-06 10:58:58 +01:00
help = "This will cause the Bridge Bot to be in private chats for the Encryption to work properly."
2023-01-08 21:50:52 +01:00
bind = "encryption>default:__FINALPATH__/config.yaml"
2023-01-06 01:26:44 +01:00
[ usermanagement ]
2023-01-06 10:58:58 +01:00
name = "Bridge Permissions"
2023-01-06 01:26:44 +01:00
services = [ "__APP__" ]
[ usermanagement . config ]
2023-01-06 10:58:58 +01:00
name = "User, Admin, Relay Management"
2023-01-06 01:26:44 +01:00
[ usermanagement . config . helptext ]
2023-01-06 10:20:02 +01:00
ask = '' '
Allowed values :
- * : All Matrix users
- domain . tld : All users on a given homeserver
- mxid ( @ user : matrix . org ) : Specific Matrix user
'' '
2023-01-06 01:26:44 +01:00
type = "markdown"
[ usermanagement . config . listuser ]
ask = "Users"
type = "tags"
visible = "role == 'user'"
[ usermanagement . config . listadmin ]
ask = "Admins"
type = "tags"
visible = "role == 'admin'"
[ usermanagement . config . listrelay ]
ask = "Relay users"
type = "tags"
visible = "role == 'relay'"
[ usermanagement . config . role ]
ask = "Role"
type = "select"
choices = [ "user" , "admin" , "relay" ]