Skip to main content
Complete every item below before running the install. The preflight check at the bottom can verify the essentials in one shot.

​
Required tools

You only need Docker. No cloud CLIs, no Node.js, no build tools.
ToolMinimum versionInstall
Docker24.0.0docs.docker.com/get-docker
Docker Compose2.20.0Included with Docker Desktop. For Linux, see docs.docker.com/compose/install
Docker Compose v2 is a plugin built into Docker CLI. Run docker compose version to confirm it is available.

​
GitHub requirements

Requirements depend on the install type.

​
Organization install

  • You are an Owner or Admin of the GitHub organization where you want to install MergeWatch.
  • You have permission to create a GitHub App under the organization.

​
Personal install

  • You are signed in to the personal GitHub account where you want to install MergeWatch. No special role is needed.
Not sure which install type to pick? Organization installs cover every repo in the org. Personal installs cover repos owned by your user account. You can always add the other later.

​
LLM provider

By default, MergeWatch uses the Anthropic API. You need an API key from console.anthropic.com.
If you want to use a different LLM provider (LiteLLM, Amazon Bedrock, or Ollama), see LLM Providers for provider-specific requirements.
If you want Amazon Bedrock as your LLM provider, you also need an AWS account with Bedrock model access enabled. See LLM Providers > Amazon Bedrock.

​
Preflight check

Run these commands to verify Docker is installed and running: 
docker compose version && docker info
You should see the Docker Compose version (2.20.0 or later) and Docker engine information. If either command fails, install or start Docker before proceeding.

Install

Ready? Deploy MergeWatch with Docker Compose.

Self-Hosting Overview

Go back to the self-hosting overview.