How to configure Assets Discovery on non GUI Linux

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

Administrators sometimes want to use Assets Discovery on a Linux environment that does not have a Graphical User Interface Configured. The Asset Discovery Tool is designed to work in a GUI and will not work without the use of a Graphical User Interface.

Environment

Asset Discovery tool version 3.x +

Jira Service Management 5.x +

Cause

  • Asset Discovery tool is only supported in GUI-enabled Linux OS. Discovery system requirements doc mentions that the Discovery tool is tested on the following platform.

    1 2 3 4 5 6 7 8 9 Ubuntu Desktop 16 Debian 9 (GNOME) Debian 9 (KDE) CentOS 7 (GNOME) Linux Mint 18.2 Cinnamon Requirements: NET Core Runtime Mono 5.2.0 or later
  • In RHEL OS as well user should have similar GUI package GNOME,KDE or Cinnamon else Discovery tool will not work as expected.

Solution

On Linux, Discovery tool must be installed on a GUI Enabled OS, otherwise it will not work as expected. There is a documentation improvement request JSDSERVER-12490 - Assets Discovery documentation requires an important update! to improve existing Discovery system requirements documentation.

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.