Xray System Requirements and Platform Support

JFrog Installation & Setup Documentation

Content Type
Installation & Setup

Xray's system requirements are dependent on the scale of your environment.

Sizings

Non-Kubernetes Deployment

Up to 100K indexed artifacts. No High Availability

Component

Nodes

CPU Cores

Memory

Disk Space

Xray and DB

1

6

24 GB

500 GB (SSD, 3000 IOPS)

RabbitMQ

1

4

8 GB

100GB (SSD, 3000 IOPS)

JFrog Advanced Security

1

6

24 GB

500 GB (SSD, 3000 IOPS)

Up to 1M indexed artifacts

Component

Nodes

CPU Cores

Memory

Disk Space

Xray

2

4

8 GB

300 GB

DB

1

8

32 GB

500 GB (SSD, 3000 IOPS)

RabbitMQ Split

3

4

8 GB

100GB (SSD, 3000 IOPS)

JFrog Advanced Security

2

8

24 GB

300 GB

Up to 2M indexed artifacts

Component

Nodes

CPU Cores

Memory

Disk Space

Xray

3

6

12 GB

300 GB

DB

1

16

32 GB

1 TB (SSD, 3000 IOPS)

RabbitMQ Split

3

4

8 GB

100GB (SSD, 3000 IOPS)

JFrog Advanced Security

4

8

24 GB

300 GB

Up to 10M indexed artifacts

Component

Nodes

CPU Cores

Memory

Disk Space

Xray

3

8

24 GB

300 GB

DB

1

16

64 GB

2.5 TB (SSD, 3000 IOPS)

RabbitMQ Split

3

4

8 GB

100GB (SSD, 3000 IOPS)

JFrog Advanced Security

8

8

24 GB

300 GB

Over 10M indexed artifacts

Contact JFrog Support.

For Xray HA (High Availability) installations (more than one node and 100k indexed artifacts), it is recommended to install RabbitMQ and Xray on separate servers using split mode. For further details, please refer to our page here.

RabbitMQ Note

RabbitMQ is a crucial component of the Xray architecture, acting as a message broker for communication between various application services. Multiple queues facilitate communication channels between producers and consumers. For more information, please refer to our page here.

Kubernetes Deployment

We have included YAML files with different sizing configurations for Artifactory, Xray, and Distribution in our GitHub pages. You can use these YAML files when you set up your cluster.

Note: From Helm chart 103.124 version of JFrog Xray, JFrog added support for Quorum Queues in RabbitMQ. This requires a minimum of three nodes of RabbitMQ and ensures fault tolerance of at least one node.  A non-HA setup of 1 node is also supported.

Note: We recommend a three-node cluster of RabbitMQ for Xray. Large clusters increase the overhead of replication and could affect the throughput. Our application has been tuned to work in a three-node setup.

Operating Systems and Platform Support

The following table lists the supported operating systems and their versions:

Product

Debian

RHEL

Ubuntu

Amazon Linux

Windows Server

Xray

10.x, 11.x

8.x, 9.x

20.04, 22.04

Amazon Linux 2023

Note

Debian 12.x and Ubuntu 24.04 are supported from Artifactory 7.104 and Distribution 2.28.

Windows 2022 is supported from Artifactory 7.125.

Supported Platforms

The following table lists the supported platforms:

Product

x86-64

ARM64

Kubernetes

OpenShift

Xray

1.27+

4.14+

Installation on Kubernetes environments is through Helm Charts. Supported Helm version is Helm 3+.

Kubernetes Sizing Requirements

We have included YAML files with different sizing configurations for Artifactory , Xray, and Distribution in our GitHub pages. You can use these YAML files when you set up your cluster.

ARM64 Support for Container-Based Installations

Artifactory, Xray and Distribution supports installation on ARM64 architecture specifically through Helm and Docker installations. When deploying a product on an ARM64 platform, an external database must be set up as Artifactory does not support the bundled database for ARM64 installations. The appropriate ARM64 Container Image is automatically pulled during the Helm or Docker installation process.