Have a question? Want to report an issue? Contact JFrog support

Skip to end of metadata
Go to start of metadata


This page presents release notes for JFrog Xray describing the main fixes and enhancements made to each version as it is released.


Click to download the latest Xray.


For installation instructions please refer to Installing Xray

Xray 1.11

Released February 18, 2018 


Enhanced Snyk Integration

The Snyk integration has expanded in JFrog Xray to provide scanning for vulnerabilities in open source dependencies across all major programming languages. Snyk support includes six additional package types to the already supported npm packages. Xray also provides two levels of Snyk integrations: Snyk Basic and Snyk Premium.

Assign OSS Licences to Components

This release provides these advanced OSS licenses functionalities:

  • Assign custom licenses to your components.
  • View the source of the originated license - custom, JFrog, or a local file.
  • View if the license was assigned directly to the component or propagated to parent components and is part of their license list.
Failure Messages

Xray now displays all impact analysis and artifact scanning failures in the new Failure Messages page, in the Admin module. This page provides administrators a single place where they can easily identify the exact step in the scanning and impact analysis Xray process in which it failed, allowing them to fix the issue and retry the step.

Page Contents

Xray 1.10

Released January 2, 2018


Grafeas API

Project Grafeas defines an open, unified metadata exchange format and API that will create a uniform and consistent way to produce and consume metadata from software components. By fully supporting the Grafeas API, Xray acts as a portal to Grafeas providing your software supply chain with an unprecedented abundance of metadata that can be easily be put to use in automated auditing and governance processes. This release of Xray exposes a set of Grafeas endpoints that are fully integrated into the Xray REST API.

Externalization of Databases

Xray works with a number of third party services, such as various databases, which were previously pre-installed with the other Xray microservices. From Xray 1.10, you have more control over your resource allocation and you can direct Xray to use an external RabbitMQ, MongoDB or PostgreSQL database in use in your organization. Keep in mind that if you direct Xray to use an external database, you have full control over the database, and also full responsibility to maintain, monitor and backup the database for Xray's use.

Improved Database Sync

Database synchronization has been significantly improved resulting in a smoother workflow, data compression and boosted performance. The enhanced compression and performance promote stability and robustness to transient network issues. Depending on your hardware, network and other factors, this may improve performance by up to 70%.

Expanded IDE Integration

In addition to UI improvements, the JFrog IntelliJ IDEA plugin has been updated to support scanning of Gradle and npm package formats in addition to the existing Maven package format. 

Issues Resolved

  1. Improved performance of Alerts page.
  2. Fixed an issue whereby Ignore Rules were not fetched when their associated Watch was deleted.
  3. Fixed an issue whereby the Event microservice crashed due to a missing checksum returned from a property search made for a build's items.
  4. Fixed an issue whereby deployed Docker Images with same SHA256 value got stuck in the analysis retry queue.
  5. Fixed an issue whereby the Xray API 'Update User' command does not update the user, and returns a 404 error.

Xray 1.10.1

Released January 4, 2018

This release includes UI display issue fixes in the Integrations and Permissions pages.

Xray 1.9

Released December 3, 2017


Authentication Through External Providers (LDAP, SAML, Crowd etc.)

User management in Xray has been greatly simplified by adding the ability to authenticate users through your corporate LDAP/Crowd or SAML provider. All you need to do is define one of the connected Artifactory instances as an "Authentication Provider". This lets you import the LDAP/Crowd, SAML and internal Artifactory users and groups from the specified Artifactory instance to Xray, and then assign them permissions as needed.

Permission Management 

This version introduces a flexible permissions model that gives an administrator fine-grained control over how users and groups access the different features of Xray.  "Resources" define the scope of a permission and specify the repositories and builds in the connected Artifactory instance to which the permission applies. You can then specify users and groups, internally defined in Xray or imported from a connected "authentication provider" as described above, and grant them privileges for the selected resources.

Feature Enhancements

  1. Improved performance of indexing and analysis for large-scale environments.

  2. Improved indexing and analysis process for Javascript files.

  3. Improved database processes which significantly improve performance of certain recursive queries

Issues Resolved

  1. Fixed an issue in which Xray would not delete files that were moved to the RabbitMQ failure queue.

  2. Fixed several issues connected to identifying the OS layer and its installed packages in Docker images.

  3. Fixed an issue that would cause RabbitMQ to drain available RAM on large scale environments by loading a large number of messages.

Xray 1.8

Released July 13, 2017


Content-Driven Workflow

Xray's current work flow is event-driven creating alerts with stateless information; a snapshot of builds and components at an instant in time. In this release, we are adding support for a new and more intuitive workflow has changed which is content-driven in that issues are displayed based on the components you are interested in. This has a huge impact on how you navigate your way to the most relevant content. The high-level flow can be summarized as:

Search for components → Drill down → Examine issues

Enhanced Search: Xray now provides enhanced search allowing you to search for specific components through a set of search filters such as package type, issue severity, version and more.

Rich component display: From the search results, you can select the component that interests you and view a rich display that provides details of all versions of the selected component

Examine issues: Selecting any issue from the components display provides detailed information on the issue as well as a list of all the artifacts and builds on which it has an impact.

Recommendations for Remediation

In addition to providing a comprehensive list of versions in which a vulnerability exists for an infected component, the rich component display in the content-driven workflow also indicates in which version a vulnerability has been fixed (if available) and recommends upgrading to that version

JFrog IntelliJ IDEA Plugin

With the JFrog IntelliJ IDEA Plugin, you can scan your Maven project dependencies using Xray and view vulnerabilities during development time directly from within the IntelliJ IDE. IDE integration support will continue to expand to additional industry-standard IDEs, and to additional package formats. 

TeamCity Integration

JFrog Xray expands its CI/CD integration capabilities by adding support for TeamCity, enabling you to scan builds, generate reports and even fail build jobs if they use components with known vulnerabilities. This is an effective way to prevent builds with vulnerabilities from entering production systems.

Enhanced Vulnerability Data

Processing of raw vulnerability data has been greatly enhanced based on improved algorithms and heuristics to correlate and match data from different sources to the right component and version. This new data model provides greater and more accurate details about vulnerabilities such as infected version ranges, fix versions and more. It also allows better identification of infected components. In the case of Maven components, the vulnerability data has been completely replaced and undergoes manual curation before being loaded into the database resulting in better coverage with fewer false-positives.

Note that you need to perform a database sync (whether you are working in online or offline mode) to work with the enhanced vulnerability data. 

Feature Enhancements

Improved Scanning Performance

Performance of scanning new builds and artifacts has been dramatically improved to orders of magnitude. Since this is the most common process that Xray performs the improvement results in Xray being more responsive on the whole. In particular, the performance and accuracy of Docker images analysis has been greatly improved.

Support for Docker Images in Builds

Docker images encased in builds are now scanned and indexed just like any other build dependency.

Issues Resolved

  1. Fixed an issue in which Xray listed a component as having an "Unknown" license, even though specific known licenses were identified.
  2. Fixed an issue in which npm dependencies with vulnerabilities were downloaded even when their hosting repository in Artifactory was set to block downloads.


Released July 17, 2017

Issues Resolved

  1. Fixed an issue which may have caused a slow database migration when upgrading Xray to a new version.

Xray 1.8.1

Released July 31, 2017

Issues Resolved

  1. Fixed an issue with Xray's analysis process causing component license data to be saved multiple times, potentially consuming high amounts of memory and disk space.

  2. Fixed an issue where license issues in alerts did not have an impact path.

  3. SaaS users will now receive email notifications with a default mail server configuration.

Xray 1.8.2

Released August 3, 2017

Issues Resolved

  1. Issues and their status, contained within Docker images in a build, are now properly propagated.

Xray 1.8.3

Released August 22, 2017

Feature Enhancements

  1. Xray now gives you the option of selecting a custom location for your Xray data and PostgreSQL directories during an installation or upgrade process.
  2. Xray has undergone system-wide performance improvements which can be seen in several screens including ComponentsIssues in component details, AlertsSecurity Reports and more.
  3. When viewing component details, you can filter the issues displayed by their Summary field.
  4. The Reports module has undergone several improvements in UI display and performance
Issue Resolved
  1. Fixed an issue in which the All Alerts tab in the Alerts screen would appear empty even when alerts were present.


Released August 24, 2017

Issues Resolved
  1. Fixed an issue where some filter selections in the Component Search did not return all applicable results.

  2. Fixed an issue with the “Cancel” button in the Artifactory instance details page.
  3. Fixed an issue where data migration was not running properly when upgrading to Xray 1.8.3 resulting in many errors in the log file.

Xray 1.8.4

Released September 25, 2017

This release brings significant OSS licenses functionalities for improved license coverage, including the ability to parse license from files, license content analysis and GitHub license matching.

Feature Enhancements
  1. Xray will now support parsing OSS license information from all popular license file conventions, such as "*.pom" and "license.txt" metadata files.
  2. An additional layer of matching logic will now be used to help classify even more OSS licenses that may have been slightly modified, by analyzing the license content and comparing it to known license types.
  3. Xray is now able to get license information from GitHub for components with a GitHub page.
  4. The Xray installer now supports writing the installation / upgrades outputs to an installer log for better traceability.

Issues Resolved
  1. The license tab will now show a "0" in the tab header when a license cannot be identified. Licenses that are identified as "unknown" will include a proper placeholder in the component details page.

  2. Better handling of multiple files associated with the same component id.
  3. The Xray Docker installation does no longer require root privileges to run.

Xray 1.8.5

Released October 17, 2017

Feature Enhancements
  1. Artifact Checksum Matching - Xray now provides more accurate results by doing a checksum match in addition to the already supported component id match. This is especially useful for files which do not have proper component id's attached to them, such as Javascript files.
  2. Performance improvements in the analysis process and Memory Consumption Enhancements.

Xray 1.8.6

Released October 19, 2017

Issues Resolved
  1. Fixed an issue in which when Xray's indexing process would fail, under certain conditions, temporary files would not be removed which could eventually deplete available storage on the filesystem.

Xray 1.7

Released April 20, 2017


New Home Page: The Xray Home page has been completely redesigned to act as a dashboard that provides a wealth of useful information. At a glance, understand your general system health, get an overview of components and alerts, system scan status, database sync status and more. 

Feature Enhancements

Package Type filter for Component search: The Components page now includes a Package Type filter that lets you focus on specific package types making it easier for you to search for specific components.

Issues Resolved
  1. If an external integration is removed, Xray will now also remove any alerts related to that integration
  2. Custom issues are now aggregated together with security vulnerabilities when viewing Component details and in REST API responses.
  3. Fixed an issue with updating properties in Artifactory that are related to Xray's indexing status.

Xray 1.7.1

Released April 24, 2017

Issues Resolved
  1. Fixed an issue with file paths that sometimes led to the wrong location.
  2. Fixed an issue with migration for component license migration.

Xray 1.7.2

Released June 5, 2017

Feature Enhancements
  1. Xray now adds a timestamp indication to build snapshots. This ensures that each snapshot will have a unique name, making it easier to work with snapshots.
  2. When updating to a new version requires migration of the database (which may take some time), Xray will now show how the upgrade is progressing and provide error information if the upgrade fails.
  3. Xray's logging facility has been improved so that you no longer have to restart Xray if you want to change the log level for any of it's services.
  4. Xray's search has been enhanced so that in addition to package type, you can now also filter searches by component type (artifacts or builds).
Issues Resolved
  1. Fixed an issue that prevented creation of custom issues due to an error in parsing the timestamp when it included the Z timezone indicator.
  2. Fixed an issue that prevented Xray from annotating artifacts in Artifactory whose name included certain special characters.
  3. Fixed an issue in which the Xray base URL in the config descriptor for a connected Artifactory instance would not be updated when the base URL was modified.
  4. Fixed an issue in which the status of some artifacts would not be modified even after they were scanned, and, as a result, their download was blocked when download blocking was enabled in Artifactory for unscanned artifacts.


Released June 6, 2017

Issues Resolved
  1. Fixed an issue introduced in version 1.7.2 which, under certain conditions, caused a database connection leak.


Released June 8, 2017

Issues Resolved
  1. Fixed an issue that prevented Xray from synchronizing its database and indexing artifacts due to too many idle connections to its PostgreSQL database.

Xray 1.7.3

Released June 25, 2017


Xray now supports setting the system log level for each of the microservices without having to restart the Xray server. 

Issues Resolved
  1. Fixed an issue in which Docker images, whose full set of layers were already included in another indexed image, would not get indexed.
  2. Fixed an issue in which the Artifact Summary REST API endpoint did not provide license information if there were no Allowed or Banner License filters defined for a watch.

Xray 1.6

Released January 18, 2017

CI/CD Integration

JFrog Xray takes an active role in your CI/CD pipeline to indicate you should fail build jobs if your build or any of its dependencies have vulnerabilities. Your CI server (currently, Jenkins CI is supported) can now send a request to Xray to scan a build that was uploaded to Artifactory. In accordance with Watches you may define, Xray will scan the build, and if vulnerabilities that trigger an alert are found, Xray can now respond to the inquiring CI server that the build job should fail.


Main Updates

  1. Fail build jobs according to Watch specifications if build artifacts or their dependencies contain vulnerabilities. 
  2. Changes in the UI for Watches replacing "Notifications" with "Actions", and the addition of the Fail Build Job action to support CI/CD integration 
  3. "All Builds" has been added a new target type for watches so you can specify that all builds uploaded to Artifactory are scanned by Xray, not only specific builds you configure into the Watch. 

Xray 1.6.1

Released January 25, 2017

Main Updates

  1. An issue that was causing artifact indexing to fail has been fixed.

Xray 1.6.2

Released February 12, 2017

Preventing Brute Force Attacks

Xray has been equipped with a login protocol to prevent brute force attacks. When Xray encounters multiple login attempts by the same user, Xray steadily increases the time interval that the user must wait before attempting login again. After a specific number of failed login attempts, the user will be locked out of his account. At that point, login can only be reset by an Xray administrator. The administrator has full control over the number of failed login attempts to lock the user out.

System Logs

An Xray administrator may now view the Xray system log file in the Admin module, with the ability to filter log messages from the different services behind Xray.

Main Updates

  1. A bug preventing Xray from reaching the global database server when a proxy server is configured was fixed. 
  2. Performance when synchronizing the global database to Xray has been greatly improved. The overall process time is dramatically reduced, both for a first-time synchronization, and for periodic updates. 
  3. A mechanism has been added to prevent brute force attacks on Xray by locking out users with multiple failed login attempts. 
  4. A bug that prevented upgrade when the upgrade archive was extracted in the same folder as the previous version, has been fixed.
  5. The impact path of an artifact is now displayed as a full path including the Artifactory instance and the repository in which the impacted artifact is hosted.
  6. The Xray log can now be viewed by an administrator in the Admin module System Logs page. 

Xray 1.6.3

Released March 7, 2017

Main Updates

  1. Xray's analysis process performance has been greatly improved
  2. Performance when generating a security report has been greatly improved, especially for Xray instances that have indexed thousands of artifacts.
  3. Alerts can now be sorted by severity, and when viewing the details for a selected alert, the tab title also displays its severity.
  4. A bug in which some impacted artifacts were omitted from the security report has been fixed. 
  5. A bug in which offline database sync was failing due to components not being found has been fixed.
  6. The scanning process performance has been greatly improved
  7. When viewing a component's details page, vulnerabilities and licenses of it's child components are also displayed.

Xray 1.6.4

Released March 14, 2017

Main Updates

  1. An issue causing proxy server functionality to fail has been fixed.

Xray 1.6.5

Released March 22, 2017

Main Updates

  1.  Improve performance of both the indexing and scanning processes.
  2.  Improve performance of security report generation.

Xray 1.5

Released January 4, 2017

Dependency Graph APIs

JFrog Xray exposes its dependency graphs to any external source with access to its REST APIs. Through a simple REST API call, you can now receive the full dependency graph of any component or build as a JSON object, or compare the dependency graphs of any two components or builds to get a clear indication of the differences between them and easily hone in on new dependencies that may have introduced issues and vulnerabilities.

 Editing System Watches

System watches are created when a repository in Artifactory has been configured to block downloads. To provide more flexibility and finer control over when alerts should be generated, system watches can now be edited by Xray admin users.

 Unknown Licenses

Handling components with unknown licenses is a matter of your organization's policy. Xray now allows you to specify if these components should trigger alerts or not.


Main Updates

  1. Dependency Graph APIs allowing you to get the graph of any artifact or build, and compare any two artifacts or builds
  2. System watches can now be edited by Admin users. 
  3. Allowed and Banned License filters now allow you to specify "Unknown" so you can decide if components with unknown licenses should trigger alerts or not. 
  4. When indexing Docker images, Xray now also indexes Debian and RPM packages in the image OS layer.
  5. The onboarding wizard UI has been improved for usability and to allow indexing selected repositories on the spot. 
  6. The Security Report display has been improved. 

Xray 1.5.1

Released January 9, 2017 

Main Updates

  1. Fixed an issue that caused a database connection leak
  2. Fixed handling of gzip files with invalid headers

Xray 1.5.2

Released January 10, 2017 

Main Updates

  1. Fixed an issue that prevented microservices from writing entries to system logs

Xray 1.4

Released December 20, 2016

Security Reports

JFrog Xray adds a new report that shows you which vulnerabilities have the most far reaching consequences in your code, and which components in your code base have the most reported vulnerabilities, as well as recent vulnerabilities and infected components that were detected.

Black Duck Integration

JFrog Xray has integrated with Black Duck Software as a new external vulnerability provider. Black Duck automates the process of securing and managing open source software by helping you comply with open source license requirements and providing security alerts about vulnerabilities discovered in open source components.

Main Updates

  1. Security Report 
  2. Black Duck integration  

Xray 1.3

Released December 4, 2016

Improved Onboarding 

The onboarding experience has been improved in several ways including a wizard that guides you through the first essential steps of configuring Xray.


The Integrations UI has been modified to be more flexible and efficiently accommodate any number of integrations with external issue and vulnerability providers.

Artifact and Build Summary REST API

The Artifact and Build Summary REST API endpoints provides general information about an artifact or build as well as an aggregated list of issues and OSS licenses associated with them.


Main Updates

  1. Onboarding improvements including an Onboarding wizard 
  2. Flexible UI for integrations 
  3. Artifact Summary and Build Summary REST APIs 

Xray 1.2

Released November 6, 2016

License Reports

Generate a report that shows the distribution of open source licenses used by artifacts indexed by Xray, as well their compliance with "Allowed Licenses" and "Banned Licenses" filters defined in all watches in the system.

System Status

Xray now monitors a variety of system parameters and reports on their status to let you easily diagnose problems. 

Issue Filters

You can now create filters on watches based on the minimum severity of issues associated with indexed artifacts. 

Main Updates
  1. License reports for distribution of OSS licenses and compliance with watches defined. 
  2. Self-monitoring system status 
  3. Checksum calculation has been optimized by running it asynchronously.
  4. Issue filters based on minimum severity of an issue associated with an artifact. 

Xray 1.1

Released September 22, 2016

Support for Older Versions of Artifactory

JFrog Xray now supports all versions of JFrog Artifactory from v4.0 and above

Synchronization with the Global Database Server

Previously, Xray would synchronize with the global database server automatically at set time intervals. To give you more control over usage of your system resources, you can now manually invoke initial synchronization and update with the global database server, and pause/resume synchronization if necessary.

Support for Non-Docker Installation

In addition to Docker, JFrog Xray is now available for installation in a variety of flavors including Ubuntu, CentOS, Red Hat, and Debian.

Support Download Blocking

JFrog Xray will annotate artifacts that have been identified with an issue in any connected instance of JFrog Artifactory so that the Artifactory administrator may block download of that artifact.

Integration with Aqua

If you have an account with Aqua, this integration lets you enable their feed as a source for alerts using your Aqua API key.

OSS License Policy

You may now implement an OSS license policy by defining a filter for watches based on a whitelist or blacklist of OSS licenses. Any component in the system that does not pass through the filter you define will generate an alert.

Main Updates
  1. Support for older versions of Artifactory - v4.0 and above
  2. Visibility and control over resources with synchronizing with the global database server 
  3. Support for Linux installations 
  4. Support download blocking 
  5. Support for manually invoking and operating synchronization with the global database server 
  6. Integration with Aqua 
  7. OSS license policies 
  8. Connect to Artifactory via an HTTP proxy

Xray 1.0

August 1, 2016

JFrog is proud to the first official release JFrog Xray 1.0. This version presents dramatic changes based on feedback recieved from customers using the previous "Preview" version released several weeks ago. 

Easy Onboarding

The entire onboarding process to get started with Xray is done within Xray. This includes adding Artifactory instances, specifying repositories for indexing, triggering indexing and getting status on the indexing process.

Unified Analysis

Watches and alerts now aggregate all types of analysis performed. You simply define the context you are interested in for a Watch (repository, build or all artifacts), and view aggregated information on issues detected and artifacts impacted in the resulting alert. 

Focusing on the most relevant issues and alerts

You can now choose to ignore alerts or issues that have been resolved or are not interesting to you either for a specific alert instance or permanently.


While JFrog Xray comes preconfigured with a database of issues and affected software artifacts, it is also open to integration with additional vulnerability providers. This version comes with the ability to add Whitesource, a simple but powerful open source security and license management solution. 

Manually Invoking a Scan

A new Watch will only apply to new Artifacts or issues that arise after it has been created. This version adds the ability to run an analysis manually and apply a new Watch on existing artiafcts and issues.

Main Updates
  1. Easy onboarding
  2. Unified analysis with Watches
  3. Focusing on important issues using "ignore" rules
  4. Integration with Whitesource
  5. Manually invoking a scan
  6. View all alerts or only those based on watches you defined
  7. Support for an HTTP proxy to communicate with external networks.

Xray 1.0.2

August 11, 2016

This is  a minor update that fixes an issue with indexing and adds a limitation on the storage Xray consumes.

Main Updates
  1. Fixed an issue that caused the indexing process to be terminated in certain cases.
  2. Xray now limits the storage it utilizes when downloading artifacts for indexing.

Xray Preview

July 3, 2016

JFrog is proud to release JFrog Xray!

JFrog Xray performs universal artifact analysis, recursively scanning all layers of your binary packages to provide radical transparency and unparalleled insight into your software architecture. JFrog Xray works with most package formats and is fully integrated with JFrog Artifactory. 


The Home screen is your dashboard where you can monitor Artifactory instance Xray are connected to, component graphs and alerts.


Watches monitor artifacts for issues, and trigger alerts if any are found. A Scanning watch monitors a named build or repository in Artifactory and triggers an alert if any dependency with issues is found. An Impact Analysis watch listens to all providers streaming information to Xray and performs an impact analysis on all components in its database for any issues reported.


Alerts provide details about any issue found with any component, showing the full infection path through the component hierarchy.


View component relationships in your repositories to understand how one component affects others.


Automate component analysis through the rich Xray REST API.