This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant previous version.

Fix 'Error using thumbnails - No image support in Java runtime'

Confluence 2.8 Documentation

Index

I am trying to use thumbnails, and I get the message: "This Confluence installation can not generate thumbnails: no image support in Java runtime"

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.

Confluence Standalone or Apache Tomcat

As a Windows Service:

  1. Open a command prompt in the Confluence install\bin directory

  2. Execute tomcat5 //US//Confluence ++JvmOptions="-Djava.awt.headless=true"

On Windows:

  1. Edit the file Confluence install\bin\setenv.bat

  2. Modify the line set JAVA_OPTS line by appending -Djava.awt.headless=true, for example set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx256m -Djava.awt.headless=true

On Linux:

  1. Edit Confluence install\bin\setenv.sh and add the '-Djava.awt.headless=true' parameter. For example JAVA_OPTS="-Xms128m -Xmx256m $JAVA_OPTS -Djava.awt.headless=true "

  2. 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)

Other Application Servers

For other application servers, you will need to append the java.awt.headless=true parameter to the JAVA_OPTS. If you need help with a particular server, please lodge a support request.

RELATED TOPICS

Configuration Guide
FAQ Home

Labels:

troubleshooting-faq troubleshooting-faq Delete
headless headless Delete
x11 x11 Delete
thumbnails thumbnails Delete
image image Delete
support support Delete
mode mode Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.
  1. Apr 25, 2007

    Andre Kolodochka says:

    If xorg libraries are not installed, you most likely to see captcha image not lo...

    If xorg libraries are not installed, you most likely to see captcha image not loading. As of today, FC6 doesn't have xorg-x11-deprecated-libs. Google suggested to use xorg-x11-deprecated-libs-6.8.2-37.FC4.49.2.1.i386 or xorg-x11-deprecated-libs-6.8.2-1.EL.13.37.5.i386 instead. However, none of them worked. The package that solved the problem in my case was xorg-x11-libs-6.7.0-14.i386.

  2. Nov 08, 2007

    Jerry Isdale says:

    This "headless=true" solution conflicts with the inablity to use that on OSX (se...

    This "headless=true" solution conflicts with the inablity to use that on OSX (see jira report)

    Oddly until I upgraded to Conflucence 2.6, this worked just fine.  I ran without headless=true and it generated thumbnails,etc just fine. 

Add Comment