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

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 entitled Fix 'Error using thumbnails - No image support in Java runtime'.

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, RHEL 5
  • 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

You'll only need the xlibs-dbg package if you're running an older version of Debian (3.0). It's a dummy package for smoothing the transition to a new set of graphics libraries, so if you can't locate it, you most likely don't need it.

Gentoo Linux

emerge libICE libSM libX11 libXext libXp libXt libXtst

Solaris 10

Please refer to the following forum for more information.

Ubuntu

Execute the following:

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

Note: 'sudo' enables you to be superuser for one operation. You will need to supply your user password.

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