This health check verifies that Jira has access to the system fonts it relies on. Missing fonts might result in errors when generating reports, or text displaying as unclear or garbled.
We’ve introduced this health check because some Java distributions don’t include any font configuration packages, which results in these problems. AdoptOpenJDK for example, does not include a font configuration package.

If you’re here, it probably means you’ll need to install this package.

Results

Icon	Result	What this means
	System fonts are available, and no issues have been detected.	No action is required.
	Some fonts are missing.	The Java distribution you're using is missing font configuration packages. You can fix this problem by installing fontconfig, as described below.

Diagnosis

When reviewing the atlassian-jira.log files, users may see the following error message indicating that system fonts are missing:

2022-08-18 09:13:22,254-0400 Caesium-1-4 WARN ServiceRunner     [c.a.t.healthcheck.concurrent.SupportHealthCheckProcess] Health check 'Fonts' failed with severity 'warning': 'System fonts are not available. Please make sure correct font packages are installed.'

In addition, users may also see that the Health Check fail for the Fonts feature in the healthcheckResults.txt file with the following error:

Name: Fonts
NodeId: null
Is healthy: false
Failure reason: System fonts are not available. Please make sure correct font packages are installed.
Severity: WARNINGAdditional links: []

Solution

Install fontconfig (or an equivalent), and restart Jira. 

Use our script to install 

The script is available in Jira 8.2 or later. If you're on an earlier version, use the commands described further below.

If you're using Ubuntu, CentOS, RedHat Enterprise (RHEL), Debian, or Fedora, we've created a script to install the required package for you. 

To install the font package:

1. Change to the /bin directory of your Jira installation

2. Run the install_fontconfig.sh script. 

   $ sudo ./install_fontconfig.sh

3. Restart Jira.

Install it yourself

Here are the commands to install the font dependency in several common Linux distributions and package managers, including Windows.

sudo apt install -y fontconfig

sudo yum -y install fontconfig

sudo yum install -y dejavu-sans-fonts

sudo yum install fontconfig

apt-get update && apt-get install -y fontconfig

dnf install -y fontconfig

Related articles

• Jira Server 7.13 or later fails with FontConfiguration error when installing on Linux operating systems
• Fonts displayed incorrect in gadgets and database monitoring graph
• Fix font healthcheck on Windows server