matrix-docker-ansible-deploy/docs/configuring-playbook-bridge-appservice-discord.md
2020-03-31 11:13:45 +03:00

1.8 KiB

Setting up Appservice Discord (optional)

The playbook can install and configure matrix-appservice-discord for you.

See the project's documentation to learn what it does and why it might be useful to you.

Setup Instructions:

loosely based on this.

  1. Create a Discord Application here.
  2. Retrieve Client ID.
  3. Create a bot from the Bot tab and retrieve the Bot token.
  4. Enable the bridge with the following configuration in your vars.yml file:
matrix_appservice_discord_enabled: true
matrix_appservice_discord_client_id: "YOUR DISCORD APP CLIENT ID"
matrix_appservice_discord_bot_token: "YOUR DISCORD APP BOT TOKEN"
  1. If you've already installed Matrix services using the playbook before, you'll need to re-run it (--tags=setup-all,start). If not, proceed with configuring other playbook services and then with Installing. Get back to this guide once ready.
  2. Retrieve Discord invite link from the {{ matrix_appservice_discord_config_path }}/invite_link file on the server (this defaults to /matrix/appservice-discord/config/invite_link)
  3. Invite the Bot to Discord servers you wish to bridge. Administrator permission is recommended.
  4. Join the rooms by following this syntax #_discord_guildid_channelid - can be easily retrieved by logging into Discord in a browser and opening the desired channel. URL will have this format: discordapp.com/channels/guild_id/channel_id

Other configuration options are available via the matrix_appservice_discord_configuration_extension_yaml variable.