If you would like to run your own instance of this plugin, you can do so by forking this repo and deploying it to your own servers or run it locally

The Probot deployment guide describes this as well

Create a GitHub App and configure the permissions & events with the following:


  • GitHub app name - Your app name
  • Webhook URL - Your webhook url for listening to events (for local deployments you can use
  • Webhook secret - Your generated webhook seceret (GitHub app page has instructions on how to create this)


  • Checks - Read & Write
  • Issues - Read & Write
  • Repository metadata - Read Only
  • Pull requests - Read Only
  • Commit Statuses - Read & Write
  • Single File - Read-only * Path: .github/mergeable.yml
  • Repository Contents - Read-Only
  • Repository projects - Read-Only

And subscription to the following events:

  • [x] Pull request
  • [x] Pull request review comment
  • [x] Pull request review
  • [x] Issues

Make sure to create a private key for the app after it’s been registered.

Running Locally

  1. Clone the forked repository on to your machine
  2. Globally install smee-client from with npm npm install -g smee-client
  3. Go to and create a new webhook OR use the cli by running the smee command.
  4. Copy .env.template to a new file called .env, and fill it out.
  5. Run npm run dev in your local repository
  6. Add a repository for your Github app by going to application settings
  7. Do a test pull request to check if everything is working

Note: if you wish to use a different config file name beside mergeable.yml, use CONFIG_PATH environment variable. Config files uses .github as base path, see [here](

Possible Issues

400 bad request / Error: No X-Hub-Signature found on request

This happens when you haven’t configured the webhook secret correctly in your locally running instance. Make sure to set the SECRET_TOKEN environment variable in .env before running npm run dev.


For a list of possible configurable variables within mergeable, check configurable-variables-page