Skip to main content

Hookshot

Dedicated Hookshot instances are available for EMS Enterprise customers. To request Hookshot added to your server, please talk to 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: CanThis can be anything
  • Homepage URL: This can be any valid URL
Callback URL: https://snowleopard-staging.ems.host/hookshot/oauth/ CallbackSetup URL: https://snowleopard-staging.ems.host/hookshot/oauth/ Webhook URL: https://snowleopard-staging.ems.host/hookshot/webhook/ 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
0151a4ba7414e401f6522985b5e53571b1bd5d5e847836b7bccc0ef53352a8c1c7b476a75dfa3bf4

Send the following information to your Element contact:

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