Documentation for Confluence 2.5.4 - 2.5.8.
Documentation for [Confluence Cloud] and the latest Confluence Server is available too.

If This Doesn't Help

If you have X11 installed and thumbnailing still does not work, please ensure that you are running Java in headless mode: see the FAQ "Fix 'Error using thumbnails - No image support in Java runtime'"

Java X11 Dependencies

On Unix-based operating systems, the Java runtime makes use of certain parts of the platform's native X11 graphics libraries. The X Server does not have to be running, but the libraries must be available on the server. Confluence will run on a server that does not have Xlib installed, but parts of the application that manipulate graphics: PDF exports, image thumbnailing, the image gallery macro, CAPTCHA, and the resizing of profile pictures, will fail.

Mac OS X

You do not need to install X11 on Mac OS X, as it has its own graphics libraries.

If X11 is not present, you may see any of the following errors

  • "This Confluence installation can not generate thumbnails: no image support in Java runtime"
  • "Exception in thread "main" java.lang.UnsatisfiedLinkError: /usr/local/j2sdk1.4.2_09/jre/lib/i386/libawt.so: libXp.so.6: cannot open shared object file: No such file or directory" when exporting a PDF
  • "NoClassDefFoundError" when uploading a profile picture

Specific Installation Instructions

Fedora Core

On Fedora Core, you will need to install the xorg-x11-deprecated-libs package. (https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=130239)

Fedora Core 6

  • libXp
  • libXp-devel (if you wish to compile against this library)

Debian Linux

On Debian, you will need to instll the following packages (CONF-6411):

apt-get install libx11-6 libx11-dev libxt6 libxt6-dbg libxext6 libxtst-dev libxtst6 xlibs-dbg xlibs-dev

Gentoo Linux

emerge libICE libSM libX11 libXext libXp libXt libXtst





Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.