2.0.0

Release Date

June 27, 2025

Introduction

Note

This release doesn’t include any breaking changes to the API or database. All existing API calls, SDKs, and CLI integrations continue to work as expected.

This major release introduces architectural changes and new features, including:

  • A redesigned user interface.

  • A migration to an Ubuntu Linux base image.

  • Updated architecture that uses HAProxy for traffic routing and supervisord for process management.

  • New caching and session management layers. They require a key or value storage engine compatible with the Redis Serialization Protocol (RESP).

  • Additional features, fixes, and improvements.

For full details, including installation steps, see On-Premises 2.x.x Admin Guide.

Features

  • UI update

  • Bi-Directional Contract Testing

  • Stub server updates

    • Stub server now supports the Pact specification up to version 4.

    • It includes additional configuration options.

Migration notes

Review the following updates when migrating to version 2.0.0:

  • You must use a Redis-compatible data store (such as Redis or Valkey). Ensure you set the REDIS_URL environment variable.

  • Set the PACTFLOW_COOKIE_SECRET environment variable to a value that is at least 64 characters. Read more in Environment Variables.

  • Do not use the PACTFLOW_LOG_FORMAT environment variable. It is deprecated and has no effect. All logs now output in JSON format only.

  • We changed the base image from Alpine Linux to Ubuntu 24.04. If you customized the image, review your setup and update any installed tools or libraries accordingly.

In this section:
© 2025
Publication date: