Installing on Linux

User rating:
1.6 (14 ratings)

The content on this page is related to a deprecated version of LoadUI, which has been superseded by LoadUI NG Pro in the Ready! API platform. Click here to learn more.

1. Installing in a graphical environment

Double-click the installer and you will soon see the starting page:


Here, you can click Next to the next page:


Here you can change the install directory, if you need to, and then click on next to  the next page:


Here, you can change where the symbolic links to the installation are created, if you wish. When you press Next, the installation will start, and it should take a couple of minutes at the most. At the end of it, you should see the end page:


At this point, the installation is complete, and you can click on Finish to dismiss the dialog.


2. Installing in a headless environment (for versions older than 2.6.8)

LoadUI agent versions older than 2.6.8 will not run out-of-the-box without a graphical environment. This is because JavaFX2 uses packages that are not assumed to be needed in an out-of-the-box Linux Server. It can be especially problematic when you are connecting via SSH or testing in the cloud without the LoadUI-Agent AMI.

This guide assumes you know how to connect to your server through SSH or similar. It also assumes a package handler called aptitude, but those may vary with different distributions. Of course, if you use 2.6.8 or higher, this guide is not necessary.

Find the agent for your system and architecture:

Follow the link and copy the link url by rightclicking the link choosing copy linkadress. if you have a 64-bit or i*86 (32-bit), then you should have the corresponding agent. You can check the architecture of your using the uname-command.


Download on your server using:




Modify it to be executable and run and follow the instructions:


chmod +x LoadUI-Agent-2.5.*.sh



Install xvfb:

To be able to use certain JavaFX2 packages inside the LoadUI Agent you need to install a Virtual Frame Buffer


sudo apt-get install xvfb

Unfortunately xvfb does not run out of the box and requires packages at runtime that are not included to run properly.



Unfortunately not everything can be bundled with the agent since the systems vary. To run both Xvfb and LoadUI-Agent you need the following dependencies.


sudo apt-get install x11-xkb-utils xserver-xorg-core xfonts-100dpi xfonts-75dpi xfonts-scalable xfonts-cyrillic libxrender-dev libxtst-dev libgtk2.0-0


Create a virtual display buffer

This command can and should be within a startup script on your machine.

It adds a virtual framebuffer and defines it as screen 99.


Xvfb :99 -ac &

This will run Xvfb in the background due to the &-sign but you can use screen or tmux or a startup script to have the Xvfb and LoadUI printouts separated. Upon startup it might throw some warning related to Fonts, this is ok.

If you decided to run it in the background, simply press ENTER to get back to the commandline.


Export the virtual display

JavaFX does not know where the virtual frame buffer resides so this needs to be defined using an environment variable defining a screen on [localhost:screen.workspace]


export DISPLAY=:99.0


Run Loadui

Assuming you installed the agent in your home folder which is the install scripts default, you should now be able to run the agent binary.