You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This major release introduces significant architectural changes and new features:
6
+
7
+
1. A redesigned user interface
8
+
- Learn more about the new interface and navigation in the [UI migration guide](/docs/user-interface/migration/new).
9
+
2. A switch to an Ubuntu Linux base image (from Alpine) for improved compatibility and security posture.
10
+
3. Internal architecture updates, including the use of `HAProxy` for traffic routing and `supervisord` for process management.
11
+
4. New caching and session management layers, requiring a Redis Serialization Protocol (RESP)-compatible key/value storage engine.
12
+
13
+
## Migration notes
14
+
15
+
The 2.x release line is almost entirely backwards compatible with 1.x. Only the following changes are required to install and run it:
16
+
17
+
1. A [Redis-compatible data store](/docs/on-premises-2x/redis) (such as Redis or Valkey) is now required.
18
+
- Ensure you set the [`REDIS_URL`](/docs/on-premises-2x/environment-variables#redis_url) environment variable.
19
+
2.`PACTFLOW_COOKIE_SECRET` must now be at least 64 characters. See [documentation](/docs/on-premises-2x/environment-variables#pactflow_cookie_secret) for details.
20
+
3. The `PACTFLOW_LOG_FORMAT` environment variable is deprecated and has no effect. All logs are now output in JSON only.
21
+
4. The base image has changed from Alpine Linux to Ubuntu 24.04. If you customized the image, review and update your setup, including any additional tools or libraries.
22
+
23
+
> **Note**: This release does not include any database or data migrations. You can freely upgrade or roll back between 1.x and 2.x without concerns about database compatibility. All existing API calls, SDKs, and CLI integrations continue to work as expected.
24
+
25
+
## Migration Checklist
26
+
27
+
Use this checklist to prepare for upgrading from PactFlow 1.x to 2.x.
28
+
29
+
✅ **Redis requirement**
30
+
-[ ] Provision a [Redis-compatible data store](/docs/on-premises-2x/redis) (Redis or Valkey).
31
+
-[ ] Set the [`REDIS_URL`](/docs/on-premises-2x/environment-variables#redis_url) environment variable.
32
+
33
+
✅ **Cookie secret length**
34
+
-[ ] Ensure `PACTFLOW_COOKIE_SECRET` is **at least 64 characters**.
35
+
-[ ] Update your environment configuration if required.
36
+
37
+
✅ **Logging format**
38
+
-[ ] Remove any usage of the `PACTFLOW_LOG_FORMAT` environment variable.
39
+
-[ ] Update monitoring/forwarding pipelines to expect **JSON logs only**.
40
+
41
+
✅ **Base image**
42
+
-[ ] Note that the base image has changed from Alpine Linux to **Ubuntu 24.04**.
43
+
-[ ] If you maintain a custom image, review and update any tools, libraries, or scripts.
The 1.x line of PactFlow On-Prem is now in maintenance mode and will only receive security updates. It will reach end of life on March 11, 2026, after which it will no longer be supported.
8
+
9
+
To ensure you have access to the latest features and improvements, please upgrade to 2.x as soon as possible.
Copy file name to clipboardExpand all lines: website/docs/docs/on-premises/releases/2.0.0.md
+3-2Lines changed: 3 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,9 +35,10 @@ For full details, including installation instructions, refer to the [2.x.x docum
35
35
36
36
Please review the following updates when migrating to version 2.0.0:
37
37
38
-
1. A [Redis-compatible data store](/docs/on-premises-2x/redis) is now required.
38
+
1. A [Redis-compatible data store](/docs/on-premises-2x/redis) is now required
39
+
1. Ensure you set the [`REDIS_URL`](/docs/on-premises-2x/environment-variables#redis_url) environment variable.
39
40
2.`PACTFLOW_COOKIE_SECRET` must now be at least 64 characters. [More info](/docs/on-premises-2x/environment-variables#pactflow_cookie_secret).
40
41
3. The `PACTFLOW_LOG_FORMAT` environment variable is deprecated and has no effect. All logs are now output in JSON only.
41
42
4. The base image has changed from Alpine Linux to Ubuntu 24.04. If you have customized the image, review your setup and update any installed tools or libraries accordingly.
42
43
43
-
> **Note:** There are no breaking API or database changes in this release. All existing API calls, SDKs, and CLI integrations will continue to work as expected.
44
+
> **Note:** There are no breaking API or database changes in this release. All existing API calls, SDKs, and CLI integrations will continue to work as expected.
0 commit comments