A github bot for merging & updating pull requests with a label.

This bot can merge and keep your branches up to date with the latest changes from base (master/main).

Place merge-with-label.yml in .github repository:

version: 1
merge:
  # specify a list of labels that indicate whether a pull request is eligible
  # for merging (regex)
  # (or-list, only one label must be present on a pull request)
  # (leave empty to disable the merge feature)
  labels:
    - "merge"
  # strategy to merge (can be "commit", "squash" or "rebase")
  strategy: "squash"
  # amount of required approvals before merging
  #requiredApprovals: 1
  # specify a list of users that are required for review (regex)
  # (and-list, all users need to approve)
  #requireApprovalsFrom:
  #  -
  # names of the checks that are need to pass before merging (regex)
  # (and-list, all checks need to pass)
  requiredChecks:
    - ".*"
  # require a linear history
  requireLinearHistory: false
  # delete branch after merging
  deleteBranch: true
  # never merge pull requests that were created by these users (regex)
  #ignoreFromUsers:
  #  - "dependabot"
  # never merge pull requests that match one of these titles (regex)
  #ignoreWithTitles:
  #  - "chore:.+"
  # never merge pull requests that match one of these labels (regex)
  #ignoreWithLabels:
  #  - "dont-merge"
update:
  # specify a list of labels that indicate whether a pull request is eligible
  # for updating (regex)
  # (or-list, only one label must be present on a pull request)
  # (leave empty to disable the update feature)
  labels:
    - "update-branch"
  # never update pull requests that were created by these users (regex)
  ignoreFromUsers:
    - "dependabot"
  # never update pull requests that match one of these titles (regex)
  #ignoreWithTitles:
  #  - "chore:.+"
  # never update pull requests that match one of these labels (regex)
  #ignoreWithLabels:
  #  - "dont-update"

1. Create a new github app with following permissions & events

   Repository Permissions

   Permission	Level
   Actions	Read
   Checks	Read and write
   Commit statuses	Read-Only
   Contents	Read and write
   Metadata	Read-Only
   Pull requests	Read and write
   Workflows	Read and write

   Subscribe to events

   • Check run
   • Pull request
   • Pull request review
   • Push
   • Status

2. Create a private key and save it

3. Note down the app id

4. Spin up the instance somewhere using docker compose

   docker-compose.yml

   services:
     postgres:
       image: supabase/postgres:17.6.1.151
       restart: unless-stopped
       volumes:
         - ./pg_data:/var/lib/postgresql/data
       environment:
         POSTGRES_USER: supabase_admin
         POSTGRES_PASSWORD: postgres
         POSTGRES_DB: postgres
       healthcheck:
         test: ["CMD-SHELL", "pg_isready -U supabase_admin -d postgres"]
         interval: 5s
         timeout: 5s
         retries: 10
   
     server:
       image: ghcr.io/eun/merge-with-label-server:latest
       restart: unless-stopped
       command: "/server"
       ports:
         - "8000:8000"
       environment:
         PORT: 8000
         PostgresDSN: "postgres://supabase_admin:postgres@postgres:5432/postgres?sslmode=disable"
       depends_on:
         postgres:
           condition: service_healthy
       healthcheck:
         test: ["CMD", "/server", "--healthcheck"]
         interval: 5s
         timeout: 5s
         retries: 12
   
     worker:
       image: ghcr.io/eun/merge-with-label-worker:latest
       restart: unless-stopped
       command: "/worker"
       volumes:
         - "./private-key.pem:/private-key.pem:ro"
       environment:
         PostgresDSN: "postgres://supabase_admin:postgres@postgres:5432/postgres?sslmode=disable"
         APP_ID: <your app id>
         PRIVATE_KEY: /private-key.pem
         HEALTH_PORT: 8001
       depends_on:
         postgres:
           condition: service_healthy
         server:
           condition: service_healthy
       healthcheck:
         test: ["CMD", "/worker", "--healthcheck"]
         interval: 5s
         timeout: 5s
         retries: 12
       deploy:
         replicas: 1

   Make sure you fill in your app id, provide the private-key.pem file and set a secure Postgres password

5. Point the webhook url to the deployment

The following environment variables are available: