Hookshot

Dedicated Hookshot instances are available for EMS customers. To request Hookshot added to your server, please talk to Support or your Account Manager.

This guide only covers EMS-specific settings. You must review the Hookshot documentation available at https://matrix-org.github.io/matrix-hookshot/latest/hookshot.html.

This guide uses my demo server with the EMS hostname and server domain snowleopard-staging.ems.host. You must use your .ems.host domain for all fields, even if your server uses Custom DNS. Replace snowleopard-staging with your hostname.

GitHub

Use the following settings for your GitHub app:

• GitHub App name: This can be anything
• Homepage URL: This can be any valid URL
• Callback URL: https://snowleopard-staging.ems.host/hookshot/oauth/
• Setup URL: https://snowleopard-staging.ems.host/hookshot/oauth/
• Webhook URL: https://snowleopard-staging.ems.host/hookshot/
• Webhook secret: Generate a random secure string
• SSL verification: Enabled
• Permissions: Configure per https://matrix-org.github.io/matrix-hookshot/latest/setup/github.html#permissions
• Subscribe to events: Configure per https://matrix-org.github.io/matrix-hookshot/latest/setup/github.html#permissions
• Where can this GitHub App be installed? Only on this account
• Example config screenshot. Changes are highlighted with arrows.
  Click the image to open it in a new tab to zoom in
  

Send the following information to your Element contact:

• App ID
• Client ID
• Client Secret
• Private Key
• Webhook Secret