# 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  
<a href="https://element.ems.host/_matrix/media/r0/download/element.io/ca419b5c17e095201e9b429d66e3472574ac3fcc" target="_blank"><img src="https://element.ems.host/_matrix/media/r0/download/element.io/847836b7bccc0ef53352a8c1c7b476a75dfa3bf4" /></a>

Send the following information to your Element contact:

- App ID
- Client ID
- Client Secret
- Private Key
- Webhook Secret