Confluence Doesn't Generate Thumbnails
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
Symptoms
Thumbnails do not render. The following appears in the atlassian-confluence.log
:
1
"This Confluence installation can not generate thumbnails: no image support in Java runtime" while generating thumbnails
Cause
On some Java installations (i.e. Unix without X11), you need to pass an additional parameter to Java when you are starting up to tell it how to use its image-manipulation libraries - to run in a headless mode, thus appending -Djava.awt.headless=true
option. Getting thumbnail support working in this configuration depends on your application server. You can learn more about Headless Mode here.
Resolution
On Linux:
Edit
Confluence install\bin\setenv.sh
and add the '-Djava.awt.headless=true' parameter. For exampleJAVA_OPTS="-Xms128m -Xmx256m $JAVA_OPTS -Djava.awt.headless=true "
If you are using Fedora Linux, you will also need to install the
xorg-x11-deprecated-libs
package. (See: https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=130239)
On Windows:
Edit the file
Confluence install\bin\setenv.bat
Modify the line
set JAVA_OPTS
line by appending-Djava.awt.headless=true
, for exampleset JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx256m -Djava.awt.headless=true
As a Windows Service:
Open a command prompt in the
Confluence install\bin
directoryExecute
tomcat5 //US//Confluence ++JvmOptions="-Djava.awt.headless=true"
Was this helpful?