# 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:

![image](https://gitlab.com/-/project/64900187/uploads/21724e8ed403f7d3a40737e39e8c5ee3/image.png)

## 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)