PRs are graciously accepted, so please come talk to us in #discord-bridge:matrix.org
about any neat ideas you might have. If you are going to make a change, please merge it with the
develop branch :).
You can also file bug reports/ feature requests on Github Issues which also helps a ton. Please remember to include logs. Please also be aware that this is an unoffical project worked on in our spare time.
The bridge supports any version of Node.js >= v12.X, including all current releases.
npm install to grab the dependencies.
npm may complain about peer dependencies, but you can safely ignore these.
config.yaml and edit it to reflect your setup.
homeserverURLto your public host name. While localhost would work, it does not resolve correctly with Webhooks/Avatars. Please note that a self-signed SSL certificate won't work, either.
bridge: domain: "example.com" homeserverUrl: "https://example.com"
node build/src/discordas.js -r -u "http://localhost:9005" -c config.yaml
Modify your HSs appservices config so that it includes the generated file.
app_service_config_files: - "discord-registration.yaml"
discord-registration.yamlto your Synapse's directory.
Following the instructions above, generate a registration file. The file may also be hand-crafted if you're familiar with the layout. You'll need this file to use the Docker image.
# Create the volume where we'll keep the bridge's files mkdir -p /matrix-appservice-discord # Create the configuration file. Use the sample configuration file as a template. # Be sure to set the database paths to something like this: # database: # filename: "/data/discord.db" # userStorePath: "/data/user-store.db" # roomStorePath: "/data/room-store.db" nano /matrix-appservice-discord/config.yaml # Copy the registration file to the volume cp discord-registration.yaml /matrix-appservice-discord/discord-registration.yaml # Optional: Build the container yourself (requires a git clone, and to be in the root of the project) docker build -t halfshot/matrix-appservice-discord . # Run the container docker run -v /matrix-appservice-discord:/data -p 9005:9005 halfshot/matrix-appservice-discord
The bridge supports reporting metrics via Prometheus. You can configure metrics support in the config
file. The metrics will be reported under the URL provided in the registration file, on the
This bridge support searching for rooms within networks via the 3pid system used in clients like Element. Any new servers/guilds you bridge should show up in the network list on Element and other clients.
npm run addbotto get a authorisation link.
Manage Webhookson the role added by the bot.
_matrixWebhook for each channel you'd like to enable this feature on.
auth.botTokencan be set with
You must get an authorization link from bridge owner. You must be a server admin or get help from server admin on Discord side.
!discord bridge ServerID ChannelID
In a vague order of what is coming up next
My Matrix ID: @Half-Shot:half-shot.uk