Mergeable
Self-HostedAutomate pull request compliance checks with customizable rules
Overview
Mergeable is an open-source tool for automating pull request (PR) checks in GitHub. It lets teams define custom rules (e.g., required labels, assignees, commit message formats, CI status) via YAML to enforce project standards. Deployable as a GitHub App (one-click) or Action (self-hosted), it integrates seamlessly with GitHub workflows, reducing manual review overhead for compliance. Supports conditional logic, public/private repos, and extensible configurations to adapt to diverse project management needs.
Self-Hosting Resources
Below is a reference structure for docker-compose.yml.
⚠️ Do NOT run blindly. Replace placeholders with official values.
version: '3'
services:
mergeable:
image: <OFFICIAL_IMAGE_NAME>:latest
container_name: mergeable
ports:
- "8080:<APP_INTERNAL_PORT>"
volumes:
- ./data:/app/data
restart: unless-stopped Key Features
- Customizable PR rule sets (labels, assignees, commit messages)
- Dual deployment: GitHub App (one-click) or Action (self-hosted)
- Integration with GitHub CI/CD workflows
- Conditional logic for complex rule configurations
- Open-source core with MIT license
Frequently Asked Questions
? Is Mergeable hard to install?
Mergeable is easy to install—either as a GitHub App (one-click from mergeable.dev) or a GitHub Action (add a workflow YAML file to your repo). The Action requires basic YAML skills, while the App is zero-config for basic use cases, making it accessible for most teams.
? Is it a good alternative to Mergify?
Yes—Mergeable offers PR automation similar to Mergify but with an open-source core (self-hosted option) and no vendor lock-in. It’s ideal for teams prioritizing customization and privacy over proprietary SaaS tools, though Mergify has more enterprise-grade features like SLA support.
? Is it completely free?
Mergeable’s open-source GitHub Action is 100% free (MIT license) for all repo sizes. The hosted GitHub App has a free tier (up to 5 repos) and paid tiers for unlimited repos/advanced support, but self-hosting via the Action costs nothing beyond standard GitHub usage.
Top Alternatives
People Also Ask about Mergeable
Tool Info
Pros
- ⊕ Privacy-focused (self-hosted via GitHub Action)
- ⊕ Free open-source version (GitHub Action)
- ⊕ Reduces manual PR compliance checks
- ⊕ Highly customizable rule sets
- ⊕ Seamless GitHub ecosystem integration
Cons
- ⊖ Limited to GitHub (no GitLab/Bitbucket support)
- ⊖ Requires YAML configuration knowledge
- ⊖ Hosted App has paid tiers for advanced features
- ⊖ No native UI for rule management
- ⊖ Steeper learning curve for complex conditional rules