Migrating from PactFlow On-Premises 1.x

Warning

PactFlow On-Premises 1.x is now in maintenance mode and receives security updates only. It will no longer be supported after March 11, 2026.

To benefit from the latest features and improvements, upgrade to version 2.x as soon as possible.

This major release introduces significant architectural changes and new features:

  • A redesigned user interface.

  • A switch from Alpine to an Ubuntu Linux base image for improved compatibility and security posture.

  • Internal architecture updates, including the use of HAProxy for traffic routing and supervisord for process management.

  • New caching and session management layers, requiring a Redis Serialization Protocol (RESP)-compatible key/value storage engine.

Migration notes

The 2.x release line remains largely compatible with 1.x. To install and run it, you must make the following changes:

  1. Use a Redis-compatible data store (such as Redis or Valkey). Ensure you set the REDIS_URL environment variable.

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

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

  4. If you customized the image, review your setup and update any installed tools or libraries accordingly. It is because we changed the base image from Alpine Linux to Ubuntu 24.04.

Note

This release does not require any database or data migrations. You can upgrade or roll back between 1.x and 2.x without database compatibility issues. All existing API calls, SDKs, and CLI integrations continue to work.

Migration checklist

Use the following checklist to prepare for the upgrade from PactFlow On-Premises 1.x to 2.x.

In this section:
© 2025
Publication date: