135 lines
3.4 KiB
Markdown
135 lines
3.4 KiB
Markdown
# Discord Bridge Setup Guide
|
|
|
|
This guide will help you set up the Discord bridge for your Dendrite Matrix server.
|
|
|
|
## Prerequisites
|
|
|
|
Before starting, ensure that:
|
|
- Dendrite is properly configured and running.
|
|
- The `discord` database was created during the initial setup.
|
|
- You have your domain name ready.
|
|
|
|
## Setup Steps
|
|
|
|
1. Navigate to the Discord configuration directory:
|
|
|
|
```sh
|
|
cd config/mautrix-discord
|
|
```
|
|
|
|
2. Generate the initial configuration file:
|
|
|
|
```sh
|
|
docker run --rm -v `pwd`:/data:z dock.mau.dev/mautrix/discord
|
|
```
|
|
|
|
3. Edit the generated `config.yaml` file. You may need administrative privileges (sudo) to edit this file.
|
|
|
|
### Required Configuration Changes
|
|
|
|
Make the following modifications to your `config.yaml`:
|
|
|
|
#### Homeserver Settings
|
|
```yaml
|
|
homeserver:
|
|
address: http://monolith:8008 # Internal Docker network address
|
|
domain: your.domain.com # Replace with your actual domain
|
|
```
|
|
|
|
#### Appservice Settings
|
|
```yaml
|
|
appservice:
|
|
address: http://discord:29334 # Internal bridge address
|
|
hostname: 0.0.0.0 # Listen on all interfaces
|
|
```
|
|
|
|
#### Bridge Settings
|
|
```yaml
|
|
bridge:
|
|
permissions:
|
|
"*": relay
|
|
"your.domain.com": user # Replace with your domain
|
|
"@yourusername:your.domain.com": admin # Replace with your Matrix ID
|
|
```
|
|
|
|
#### Database Connection
|
|
Update the database URI to use the Discord-specific database:
|
|
|
|
```yaml
|
|
# Original:
|
|
# postgres://dendrite:password@postgres/dendrite?sslmode=disable
|
|
|
|
# Modified (note 'discord' database name):
|
|
postgres://dendrite:password@postgres/discord?sslmode=disable
|
|
```
|
|
|
|
4. Generate the registration file:
|
|
|
|
```sh
|
|
docker run --rm -v `pwd`:/data:z dock.mau.dev/mautrix/discord
|
|
```
|
|
|
|
5. Configure Dendrite to use the Discord bridge by editing `config/dendrite/dendrite.yaml`:
|
|
|
|
```yaml
|
|
app_service_api:
|
|
config_files:
|
|
- "/etc/discord/registration.yaml"
|
|
```
|
|
|
|
6. Start the bridge service:
|
|
|
|
```sh
|
|
docker compose up -d mautrix-discord
|
|
```
|
|
|
|
7. Restart Dendrite to load the new bridge configuration:
|
|
|
|
```sh
|
|
docker compose restart monolith
|
|
```
|
|
|
|
## Verifying the Setup
|
|
|
|
Check if the bridge is running:
|
|
|
|
```sh
|
|
docker compose logs mautrix-discord
|
|
```
|
|
|
|
You should see messages indicating the bridge has started successfully. If the configuration files aren't present, the service will remain stopped - this is normal and prevents unnecessary restarts.
|
|
|
|
## Using the Bridge
|
|
|
|
1. Start a chat with `@discordbot:your.domain.com` in your Matrix client.
|
|
2. Follow the bot's instructions to:
|
|
- Set up a Discord bot account.
|
|
- Add the bot to your server.
|
|
- Link your Discord account.
|
|
|
|
## Troubleshooting
|
|
|
|
1. **Bridge Not Starting**
|
|
- Verify that both config.yaml and registration.yaml exist.
|
|
- Check file permissions.
|
|
- Review logs with `docker compose logs mautrix-discord`.
|
|
|
|
2. **Bot Connection Issues**
|
|
- Verify bot token is correct.
|
|
- Check if all required intents are enabled.
|
|
- Ensure bot has proper permissions in Discord.
|
|
|
|
3. **Channel Bridging Issues**
|
|
- Verify bot has access to the channel.
|
|
- Check if the channel type is supported.
|
|
- Ensure proper permissions in both Discord and Matrix.
|
|
|
|
4. **Message Delivery Problems**
|
|
- Check bridge permissions in config.
|
|
- Verify room configuration.
|
|
- Ensure Discord connection is active.
|
|
|
|
## Next Steps
|
|
|
|
For more detailed information about bridge features and configuration options, visit the [mautrix-discord documentation](https://docs.mau.fi/bridges/general/docker-setup.html?bridge=discord).
|