Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Pact Broker

github.com

  • Free plan
  • Linux
  • Web
  • API
  • Self-hosted
7.6 Club score Visit github.com

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.

Enterprise (PactFlow)

—

Pact Broker (self-hosted)

Free

Starter (PactFlow)

Free

Team (yearly, PactFlow)

$115.42/mo

Free plan

Getting started

  1. Open the Pact Broker GitHub project or PactFlow
  2. Choose self-hosted deployment or a PactFlow plan
  3. Deploy with Docker or use Terraform on AWS
  4. Use PostgreSQL for broker storage, or SQLite for quick-start and CI use
  5. Configure authentication users if using the Docker distribution
  6. 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.