Configuration¶
Minimal setup¶
For a minimal prosody <https://prosody.im>
based setup, add these lines at the bottom of
/etc/prosody/prosody.cfg.lua
:
Component "matridge.example.org"
component_secret = "secret"
And start matridge with:
matridge \
--jid matridge.example.org \
--secret secret \
--home-dir /somewhere/writable
Advanced usage¶
Refer to the slidge admin docs for more advanced setups and examples of configuration for other XMPP servers.
You will probably want to add support for attachments received from Matrix, and setup matridge as a privileged component for better UX.
matridge-specific config¶
All generic slidge configuration options apply. matridge provides these additional component-wide options:
MAX_HISTORY_FETCH | Number of events to fetch to back-fill MUC history before slidge starts up. |
MAX_PARTICIPANTS_FETCH | Number of participants to fetch when joining a group. Higher values will make joining slower, and participants will appear when they speak or if they spoke in the back-filled events. Participants with power levels > 50 (ie, admins) will be fetched. |
NIO_VERBOSE | Set this to True to respect the global log level from the matrix lib. It's REALLY verbose, so the default is to use WARNING. |
PARSE_MESSAGE_STYLING | Convert Message Styling (XEP-0393) message bodies to Matrix custom HTML. Supported markup: _underline_ *bold* ~strikethrough~ `code span` ```code block``` >quote ||spoiler \_escape style_ |
REACTION_CACHE_SIZE | Emoji reaction cache size, in number of messages |