Pact Broker
github.com
- Free plan
- Linux
- Web
- API
- Self-hosted
What Pact Broker is
Pact Broker is a contract registry for sharing consumer-driven contracts and verification results. It is optimized for Pact contracts and also accepts contracts that can be serialized to JSON. Its compatibility matrix helps teams check whether consumer and provider versions can be deployed together safely. In a CI workflow, consumer builds publish pacts, provider builds retrieve and verify them, and consumers can use the can-i-deploy command before deployment. The REST API supports publishing and retrieving pacts; the broker also offers an embedded API browser, generated documentation, service network diagrams, verification results and status badges. Webhooks can trigger actions when a pact changes, such as starting a provider build or sending a Slack notification. Deployment documentation covers Docker, Terraform on AWS, PostgreSQL and SQLite for quick-start and CI use, though SQLite is not supported for long-term operation. The self-hosted broker is free, with hosting, operation, security, maintenance and upgrades left to users. PactFlow lists paid Team plans at $115.42 a month billed yearly or $127 a month billed monthly.
Who it suits
It suits teams using Pact contracts in consumer and provider CI workflows who need to check deployment compatibility. Teams that self-host should be prepared to handle operation, security, maintenance and upgrades.
Good to know, and what to watch
- Compatibility matrix checks deployable consumer-provider versions.
- CI workflows support publishing and verifying pacts.
- REST API supports publishing and retrieving pacts.
- Docker images support linux/amd64 and linux/arm64.
- SQLite is not supported for long-term operation.
- Self-hosted users handle security, maintenance and upgrades.
Plans
Every plan and priceEnterprise (PactFlow)
Pact Broker (self-hosted)
Starter (PactFlow)
Team (yearly, PactFlow)
Free plan
Getting started
- Open the Pact Broker GitHub project or PactFlow
- Choose self-hosted deployment or a PactFlow plan
- Deploy with Docker or use Terraform on AWS
- Use PostgreSQL for broker storage, or SQLite for quick-start and CI use
- Configure authentication users if using the Docker distribution
- Publish consumer pacts and retrieve them from provider builds
Limits to check
The self-hosted broker is free, but hosting, operation, security, maintenance, and upgrades remain with the user. PactFlow Starter is free with unlimited users and two integrations; Team plans provide 50 integrations.
The Club's review
Pact Broker is a contract registry and verification service for teams coordinating changes between software consumers and providers. It is strongest for engineering groups already using Pact and able to operate their own broker. Its standout value is connecting published contracts and verification results to a compatibility check before deployment.
Overview
In a typical CI workflow, consumer builds publish contracts, provider builds retrieve and verify them, and consumers can run can-i-deploy to check whether a release is compatible with the versions already in use. The compatibility matrix makes that relationship visible across consumer and provider versions, helping teams catch unsafe combinations before deployment rather than relying on coordination by hand.
The broker is optimized for Pact contracts covering HTTP and message interactions, but it also accepts contracts that can be serialized as JSON. It supports consumer and provider verification, contract registration and GraphQL. Its REST API lets automated systems publish and retrieve contracts, while the embedded API browser gives users a way to inspect that interface.
Key features
Autogenerated contract documentation, service network diagrams, verification results and status badges help teams understand contract state and service relationships. Webhooks can react to pact changes by starting a provider build or notifying a Slack channel, linking registry updates to the next step in a team’s workflow.
For deployment, the compatibility matrix and can-i-deploy command are more consequential than the registry alone: they give teams a way to check whether particular service versions can safely go live together. The Docker distribution supports configurable basic-auth users with read/write or read-only privileges, and its images target linux/amd64 and linux/arm64.
Deployment options include Docker and Terraform on AWS. PostgreSQL is documented for persistent use; SQLite is offered for quick-start and CI scenarios, but not for long-term broker operation. The Docker project describes security scanning with bundler-audit, Trivy on published image digests and weekly scans, and Renovate. The repository uses the MIT license.
Pricing
The self-hosted Pact Broker plan is free and provides the open-source broker, but the team supplies hosting and takes responsibility for operation, security, maintenance and upgrades. That makes it a sensible fit for teams with infrastructure capacity, not a zero-effort managed service.
PactFlow offers a hosted route with a free Starter plan at no cost, including unlimited users, two integrations and bi-directional contract testing. Its Team plan costs $115.42 a month billed yearly as $1,385, or $127 a month billed monthly; both include 50 integrations, community support, and GitHub and Google login. The yearly option lowers the monthly rate but commits the buyer to annual billing.
Enterprise has custom pricing and includes SAML SSO, role-based access management, dedicated support, and SaaS or on-premise deployment. The self-hosted broker avoids a software fee, while PactFlow’s paid tiers offer a hosted option and, at Enterprise level, dedicated support and access controls.
Platforms
Pact Broker is offered through an API, web interface, Linux and self-hosted deployment. Its multi-platform Docker images cover linux/amd64 and linux/arm64. The project points users to its wiki, GitHub issues, Stack Overflow’s pact-broker tag and Pact Slack for support.
Who it's for
It suits teams using consumer-driven contracts to coordinate independently deployed services, particularly where CI can publish and verify pacts and deployment decisions need a compatibility check. Teams comfortable running infrastructure can use the open-source broker directly; those wanting a managed service can consider PactFlow. It is a weaker fit for organizations that do not use Pact-style contracts or cannot take on broker operations.
Pros and cons
- Pro: The compatibility matrix and can-i-deploy check turn contract verification into a concrete pre-deployment safeguard.
- Pro: REST access and webhooks support automated publishing, retrieval and follow-up actions in CI.
- Pro: The open-source broker is free to use and offers documented Docker and AWS Terraform deployment paths.
- Con: Self-hosted users own hosting, security, maintenance and upgrades; the free software price does not remove that operational cost.
- Con: SQLite is not suitable for long-term broker operation, so persistent deployments need another documented database option such as PostgreSQL.
- Con: Pact is the primary contract format, so teams centered on other API-contract approaches may find a more specialized alternative a better match.
Alternatives
For a broader comparison, see Contract Testing Tools. oasdiff is worth considering when an open-source engine under Apache 2.0, including a CLI and GitHub Action, better suits the workflow. Choose Pact for its open-source tooling if the broker itself is not the focus.
Confluent Cloud is a different option for teams seeking managed Kafka clusters and connectors. GraphQL Hive may suit teams focused on GraphQL schema and usage management. PactFlow is the related hosted option, with free Starter and paid Team and Enterprise plans. Microcks is an open-source alternative, while Specmatic offers an open-source contract-testing option. Karate is a free framework option for API testing.
Verdict
Choose Pact Broker if your team uses Pact and wants contract publication, verification and deployment compatibility checks joined in one workflow. Its free, open-source self-hosted edition is compelling for teams prepared to run it; look elsewhere if you need a managed service without moving to PactFlow or do not want to maintain broker infrastructure.
The verdict
Pact Broker links contract publication and verification with a compatibility check before deployment. Self-hosting has no listed price, but teams take on the operational responsibilities themselves.
Questions people ask
Is Pact Broker free?
The self-hosted Pact Broker is listed as free under the MIT license. PactFlow also lists a free Starter plan.
Can Pact Broker be self-hosted?
Yes. Self-hosted deployment is supported, with Docker and Terraform on AWS documented.
Which databases are supported?
Documentation covers PostgreSQL and SQLite for quick-start and CI use. SQLite is not supported for long-term broker operation.
What platforms do the Docker images support?
The Docker project provides multi-platform images for linux/amd64 and linux/arm64.
What does PactFlow Team cost?
Team costs $115.42 a month billed yearly, or $127 a month billed monthly. Both plans include 50 integrations, community support, and GitHub and Google login.
Does it support contract verification?
Yes. Pact Broker supports both consumer verification and provider verification, with verification results available in the broker.
What the maker publishes
- API availability
- The Pact Broker exposes a RESTful API for publishing and retrieving pacts. source
- Authentication
- The Docker distribution supports configurable basic-auth users with read/write and read-only privileges. source
- Automation
- Webhooks can trigger actions when pacts change, such as running a provider build or notifying a Slack channel. source
- CI workflow
- Consumer builds publish pacts, provider builds retrieve and verify them, and consumers can use the can-i-deploy command to check before deployment. source
- Core features
- Features include a REST API, embedded API browser, autogenerated pact documentation, service network diagrams, verification results, and status badges. source
- Free trial
- PactFlow's Team plan offers a free 14-day trial, and its Starter plan is listed as free. source
- Headquarters
- Melbourne, Australia source
- Integrations
- The project documents Docker deployment, Terraform on AWS, PostgreSQL, and SQLite for quick-start and CI use; SQLite is not supported for long-term broker operation. source
- License
- The Pact Broker repository is published under the MIT license. source
- Purpose
- Pact Broker shares consumer-driven contracts and verification results, and is optimized for Pact contracts while also accepting contracts serializable to JSON. source
- Safe deployments
- It provides a compatibility matrix to identify consumer and provider versions that can safely be deployed together. source
- Security scanning
- The Docker project says it uses bundler-audit, Trivy scans on published image digests and weekly, and Renovate. source
- Support
- The project directs users to its wiki, GitHub issues, Stack Overflow with the pact-broker tag, and Pact Slack. source
- Supported platforms
- The Docker project provides multi-platform images for linux/amd64 and linux/arm64. source
Checked against the maker's pages on 30 Sept 2026.