From 0ff8738e86676d1d8791073ad3ce6848d664faab Mon Sep 17 00:00:00 2001 From: Astra Logical Date: Thu, 30 Jul 2026 19:13:01 -0400 Subject: [PATCH] Added info on bridging discord to matrix --- .../communication-and-security/matrix.md | 32 +++++++++++++++++-- 1 file changed, 29 insertions(+), 3 deletions(-) diff --git a/docs/user-facing/communication-and-security/matrix.md b/docs/user-facing/communication-and-security/matrix.md index c6c6f35..7fb6207 100644 --- a/docs/user-facing/communication-and-security/matrix.md +++ b/docs/user-facing/communication-and-security/matrix.md @@ -46,7 +46,33 @@ If you are accustomed to Discord, Matrix has a slightly different vocabulary, bu --- -## 4. Voice & Video Calls +## 4. Bridging Discord Servers to Matrix + +Want to bridge your Discord server to Matrix to enable real-time message syncing both to and from Matrix? You're in luck! A Discord bridge has already been established for The Nest. Here are a few things to note: + +> [!WARNING] **Account Puppeting** +> **YOU CANNOT BRDIGE DMs.** It is against ToS to automate (puppet) your own account. Breaking this rule can and has lead to **bans** of both the puppetted account **and everyone in the DM.** The Nest will not support double-puppeting. +> +> If you wish to bridge a group chat, convert it to a Server first. +> +> *We hate this. We do not like Discord.* + +1. In order to establish a bridge, you must have the **"Manage server"** role in the server in question. +2. You must be okay with accepting a bot with **adminitrative priviliges** into your server. + - This is 100% okay by ToS. There are other ways to bridge that are not. The bot is safe. +3. It will backfill everything that you have visibility into, including media. If you are uncomfortable with this, let us know before we bridge. + - Note: role-restricted channels will need their permissions updated post-import. +4. It may not be immediately obvious is a message is from Matrix or Discord. +5. Due to limitations in some more modern matrix protocols, bridged rooms are **not encrypted**. You may enable encryption afterward, but it will stop the bridge from syncing. + +Okay with the above? Reach out to an admin to get started! + +> [!TIP] **Going Cold Turkey** +> Want to just do a one-time import and ditch Discord altogether? We support it! Let us know when you reach out! + +--- + +## 5. Voice & Video Calls Matrix handles voice and video calls seamlessly using real-time WebRTC media streaming. @@ -59,7 +85,7 @@ Matrix handles voice and video calls seamlessly using real-time WebRTC media str --- -## 5. System Service Endpoints +## 6. System Service Endpoints For reference or advanced client setup, here are the service endpoints powering Matrix on The Nest: @@ -73,7 +99,7 @@ For reference or advanced client setup, here are the service endpoints powering --- -## 6. Troubleshooting & Related Services +## 7. Troubleshooting & Related Services * **Requesting Access to New Services:** Send a direct message to `@access-bot:starling.mynest.love` inside Matrix to request permissions. - **Ask an Admin:** All Nest users should have access to the **Admin** space and **Ask an Admin** room. Use this room to ask questions, report issues, and seek help. If you have a problem, check **Ask an Admin** to see if someone else has run into the same issue!