Matrix-Synapse

Synapse is a Matrix homeserver. Matrix is an open network for secure, decentralised communication.

View the nix-core NixOS module on GitHub.

References

• repo
• docs
• coturn

Register users

register_new_matrix_user -u USERNAME -p PASSWORD

Sops

Provide the following entries to your secrets.yaml:

Replace abc123 with your actual secret(s)

coturn:
    static-auth-secret: abc123
matrix:
    registration-shared-secret: abc123

DNS

Make sure you have a CNAME record for turn pointing to your domain.

Bridges

Warning: Bridges use mautrix-go which relies on deprecated libolm.

NixOS configuration

The config.yaml for each bridge is managed through services.mautrix-BRIDGE.settings:

• services.mautrix-signal.settings: example configuration file
• services.mautrix-whatsapp.settings: example configuration file

Authentication

1. Open chat with bridge bot: @BOT:DOMAIN.TLD
   • WhatsApp: whatsappbot
   • Signal: signalbot
2. Send: login qr
3. Scan QR code
4. Switch puppets: login-matrix ACCESS_TOKEN
   • Get your token with: Settings > Help & About > Advanced > Access Token

Troubleshooting

Specified admin user is not an admin in portal rooms

There seems to be a bug that the user specified under services.matrix-synapse.bridges.whatsapp.admin does not have admin permissions in portal rooms. You can set the power level manually inside each portal room:

!wa set-pl @YOU:DOMAIN.TLD 100