Uninstalling the GitHub App (Step 1) is sufficient to stop all reviews immediately. The Docker cleanup steps are optional but recommended.
Full removal process
Uninstall the GitHub App
- Go to GitHub Settings > Applications
- Find MergeWatch and click Configure
- Click Uninstall
This stops all webhook delivery immediately. No new reviews will be triggered.Stop the containers
This stops and removes the MergeWatch and PostgreSQL containers. Your data in the Postgres volume is preserved. Remove data (optional — destructive)
To also remove the PostgreSQL volume and all stored data:This permanently deletes all review history, installation config, and repository settings stored in PostgreSQL. This action cannot be undone.
Delete the GitHub App (optional)
If you no longer need the GitHub App registration:
- Go to GitHub Settings > Developer settings > GitHub Apps
- Find MergeWatch
- 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.
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.