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.

  

Send the following information to your Element contact:

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