Artifactory and Xray Compatibility Matrix

If you self-host both JFrog Artifactory and JFrog Xray, the two products must stay within two quarterly releases of each other. This is the N-2 compatibility window. Version pairs outside this window are unsupported: core integration features may not work correctly, and JFrog Support will not cover issues reported against them. Before installing or upgrading either product, consult the Version Alignment Reference table to confirm your version pair is within the supported window. If your environment has already drifted beyond N-2, contact JFrog Support before attempting any upgrade.

This policy applies to self-managed Quarterly Release deployments only. If you use JFrog Cloud, version alignment is managed automatically and this matrix does not apply.

Version Alignment Reference

Both Artifactory and Xray follow a quarterly release cadence. Each quarter, JFrog publishes a new minor version baseline for each product. In this matrix, N is the current minor version baseline, N-1 is the previous minor version baseline, and N-2 is two minor versions back. Patch releases within a baseline (for example, 7.146.7 and 7.146.15) are equivalent for compatibility purposes.

Use the following table to identify which minor version baseline (N, N-1, or N-2) your installed version belongs to before planning an upgrade.

The minor version gap between quarterly Artifactory baselines is not a fixed number. Do not attempt to calculate N-1 or N-2 by subtracting from the minor version digit. Always refer to the Version Alignment Reference table.

N-2 Compatibility Policy

JFrog supports a rolling three-version compatibility window (N-2) between Artifactory and Xray quarterly releases. An active version of either product supports the current version and the two previous quarterly release versions of the peer product.

The following table shows all supported version combinations.

Supported combinations: JFrog has tested this version pair. Core integration features function as documented and JFrog Support covers issues reported against these combinations.

Unsupported combinations: Version pairs outside the N-2 window have not been tested by JFrog. Core integration features may not function correctly and JFrog Support does not cover issues reported against these combinations.

📘

New Features at the N Boundary

Some Xray features introduced in a given quarter require the matching Artifactory N release. If a feature is unavailable after upgrading Xray, verify that Artifactory is also at N. Feature-specific version requirements are listed in the Xray release notes for that version.

Upgrade Planning Examples

The following examples use current Quarterly Release versions where Artifactory 7.146.x and Xray 3.143.x represent the N baseline.

Example 1: Upgrading Xray While Keeping Artifactory Static

If your environment is running Artifactory 7.146.x (N), the following Xray versions are supported.

Attempting to connect Artifactory 7.146.x to Xray 3.124.x (N-3) falls outside the compatibility window and is not supported by JFrog.

Example 2: Upgrading Artifactory to the Edge of the Window

Consider an environment running Artifactory 7.125.x and Xray 3.131.x. Both products are at N-2 in the current quarter.

If you upgrade Artifactory directly to 7.146.x (N) without first upgrading Xray:

• Result: Artifactory 7.146.x (N) + Xray 3.131.x (N-2) is within the supported window.
• Risk: Xray is now at the oldest supported version. Any further Artifactory upgrade, including the next quarterly release, will move Xray outside the window. You have no upgrade runway on the Artifactory side until Xray is brought to at least 3.137.x (N-1).

Recommended Sequence: Upgrade Xray to 3.137.x or 3.143.x before upgrading Artifactory to 7.146.x. This keeps both products mid-window and preserves runway for future upgrades of both products.

Deployment Notes

Patch releases: The third version digit does not affect compatibility. All patch releases within a quarterly minor baseline (for example, 7.146.7, 7.146.10, and 7.146.15) are treated identically for the purposes of this policy.

Upgrade order: When both products are behind, upgrade the product that is furthest from the current N first. Upgrading one product while the other remains far behind increases the version gap and risks pushing the combination outside the window.

If your combination has drifted beyond N-2: Contact JFrog Support before planning an upgrade. Do not attempt to close a large version gap in a single upgrade operation.

Scope of this policy: This policy covers self-managed Quarterly Releases only. It does not apply to release candidates or preview builds.

Frequently Asked Questions

This section provides answers to frequently asked questions.

Related Topics

• Xray Upgrade
• Artifactory Upgrade
• Product Dependencies Matrix