Skip to main content
Uninstalling the GitHub App (Step 1) is sufficient to stop all reviews immediately. The Docker cleanup steps are optional but recommended.

Full removal process

1

Uninstall the GitHub App

  1. Go to GitHub Settings > Applications
  2. Find MergeWatch and click Configure
  3. Click Uninstall
This stops all webhook delivery immediately. No new reviews will be triggered.
2

Stop the containers

docker compose down
This stops and removes the MergeWatch and PostgreSQL containers. Your data in the Postgres volume is preserved.
3

Remove data (optional — destructive)

To also remove the PostgreSQL volume and all stored data:
docker compose down -v
This permanently deletes all review history, installation config, and repository settings stored in PostgreSQL. This action cannot be undone.
4

Delete the GitHub App (optional)

If you no longer need the GitHub App registration:
  1. Go to GitHub Settings > Developer settings > GitHub Apps
  2. Find MergeWatch
  3. Click Edit then Delete GitHub App
You can skip this step if you plan to re-install MergeWatch later. The app registration has no cost.

Platform-specific teardown

If you deployed MergeWatch to a specific platform, you may need additional cleanup steps:

Platform Guides

Google Cloud Run, AWS ECS, Azure, Fly.io, Railway, and more.

Re-install MergeWatch

Changed your mind? Set up MergeWatch again in under ten minutes.