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: Can be anything
Homepage URL: https://snowleopard-staging.ems.host/
Callback 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
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