2024-11-27 16:05:31 -03:00

69 lines
2.1 KiB
Markdown

# Dendrite Docker Bridges
A simple way to set up Dendrite with bridges for WhatsApp, Telegram, and Discord.
## Before Starting
1. Make sure you set up your domain by following this documentation: [Dendrite Domain Name Setup](https://element-hq.github.io/dendrite/installation/domainname).
2. Ensure you have `docker` and `docker compose` installed on your server.
3. All commands will be executed in the project root, i.e., the directory where the repository was cloned.
## Installation
1. Clone this repository and enter the directory:
```sh
git clone https://gitlab.com/rogs/dendrite-docker-bridges.git
cd dendrite-docker-bridges
```
2. Run `setup.sh`:
```sh
./setup.sh
```
This script will prompt you for your domain (the one you configured in "Before Starting") and create your private key and config in the `./config/dendrite` directory. When it finishes, make sure to copy the "Registration shared secret," as you will need it for the next step.
3. Open your configuration file located at `./config/dendrite/dendrite.yaml`. **You may need `sudo` to edit this file.** Search for `registration_shared_secret` and paste the registration secret you copied in the previous step. The section should look similar to this:
```yaml
client_api:
registration_disabled: true
registration_requires_token: false
registration_shared_secret: "YourBigCopiedKey123" # This is your key!
guests_disabled: false
enable_registration_captcha: false
recaptcha_api_js_url: ""
```
4. Start Dendrite:
```sh
docker compose up -d postgres monolith
```
5. Run `setup-db.sh`:
```sh
./setup-db.sh
```
This script will create three new databases: `whatsapp`, `telegram`, and `discord`. These will be used later for the bridges.
6. Verify the setup by navigating to `http://your-ip-address:8008` in your browser. You should see a screen similar to this:
```sh
# TODO Add picture
```
## That's It!
Dendrite is now up and running! You can proceed with setting up the bridges:
- [WhatsApp Bridge](./config/mautrix-whatsapp/README.md)
- [Telegram Bridge](./config/mautrix-telegram/README.md)
- [Discord Bridge](./config/mautrix-discord/README.md)