Installing the QuickHMI Runtime on Linux-Systems


The installation of the QuickHMI - Server on a Linux distribution is done via the terminal. Please note the system requirements for Linux!

Open a terminal or connect to your Linux system via SSH access.


The commands to be executed may differ from distribution to distribution. The commands in this manual are based on Linux Ubuntu.



  1. Install an openJDK runtime environment. Runtime environments from version 11 on are supported.


sudo apt-get install openjdk-11-jre




  1. If you want to use the graphical runtime manager, install openjfx. Otherwise, you can skip this step.


sudo apt-get install openjfx




  1. Create a new user quickhmi with the password indi. This user will be used to start the QuickHMI Server.


username="quickhmi"
password="indi"
pass=$(perl -e 'print crypt($ARGV[0], "password")' $password)
sudo useradd -m -p $pass $username




  1. Change to directory „/home/quickhmi“.


cd /home/quickhmi




  1. Download the QuickHMI Server package. Instead of using the wget command, you can of course download the file on

another computer first,and then copy it into the current directory (/home/quickhmi).


sudo wget https://www.quickhmi.de/linux/falcon/QuickHMIServer.tar




  1. Unpack the QuickHMI Server package to /home/quickhmi


sudo tar -xvf QuickHMIServer.tar


You should now find the following folder structure: /home/quickhmi/QuickHMIServer




  1. Delete the QuickHMI Server package


sudo rm QuickHMIServer.tar




  1. Set the user quickhmi as owner of the folder QuickHMIServer.


sudo chown quickhmi QuickHMIServer




  1. Create a symbolic link to the file /home/quickhmi/QuickHMIServer/qhmiRM.sh in /usr/bin/qhmiRM.


sudo ln -s /home/quickhmi/QuickHMIServer/qhmiRM.sh /usr/bin/qhmiRM




  1. Copy the folder /home/quickhmi/QuickHMIServer/usr/ to /usr/.
    The cp -a command copies the folder with all its contents.
    Important for this command is the / after specifying the source directory!


sudo cp -a QuickHMIServer/usr/. /usr/




  1. You can now delete the folder /home/quickhmi/QuickHMIServer/usr. It is no longer needed here.


sudo rm -rf QuickHMIServer/usr




  1. Copy the folder /home/quickhmi/QuickHMIServer/etc/ to /etc/.
    The cp -a command copies the folder with all its contents.
    Important for this command is the / after specifying the source directory!


sudo cp -a QuickHMIServer/etc/. /etc/




  1. You can now delete the order /home/quickhmi/QuickHMIServer/etc. It is no longer needed here.


sudo rm -rf QuickHMIServer/etc



And with that the installation is completed.

For example, enter sudo qhmiRM to get a list of possible commands.