Confluence UI shows garbled or corrupt text on CAPTCHA, macros and/or diagrams due to missing fonts

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

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

Problem

Following a Confluence upgrade running on an older Linux distribution, you might encounter a problem where certain system text in the application will appear to be garbled and look like symbols instead of regular alphanumeric letters.

You will not see any errors in the logs relating to the issue, however, you might see warnings about fonts in general. 

This has been observed in the following areas of Confluence

CAPTCHA

Macro headers

Inline charts and diagrams


Imported Microsoft Word Documents


Diagnosis

In order to identify whether you are affected by this issue, you will need to answer the below questions:

  • Did you upgrade Confluence Server recently to a new version?
  • Are you running an older version of a Linux distribution that is behind current release cycle (possibly more than 3+ years old)?

Cause

If you answered yes to both of the above questions, you might be missing fonts on the OS level that more recent versions of Confluence depend on to render pages properly. Bug report for reference:  CONFSERVER-54067 - Getting issue details... STATUS

Resolution

Resolution 1

Uninstall lyx-fonts package (Lyx/MathML fonts - A collection of Math symbol fonts for lyx)

Resolution 2

You will need to check and install the following font packages. You can use any package manager you like. For this example, we will be using yum

yum install ghostscript
yum install dejavu-fonts-common
yum install dejavu-sans-fonts
yum install dejavu-sans-mono-fonts
yum install motif

Some versions of ghostscript packages can be affected by security vulnerability CVE-2018-16509 discovered in September 2018.


for more details see


In order for Confluence to pick up the changes, please apply the below steps:

  1. Stop Confluence
  2. Rebuild the font cache by using the following command:

    fc-cache -s
  3. Clear the Confluence Plugins Cache.
  4. Perform a Content Index Rebuild.
  5. Start Confluence.
  6. Clear your browser cache and verify Confluence is presenting the text properly.
  7. If you still see garbled text, try rebooting the server, then check again.


Description

Following a Confluence upgrade running on an older Linux distribution, you might encounter a problem where certain system text in the application will appear to be garbled and look like symbols instead of regular alphanumeric letters.

You will not see any errors in the logs relating to the issue, however, you might see warnings about fonts in general. 


Product

Confluence


Last modified on Sep 22, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.