Deploying Qt for Embedded Linux Applications

The procedure of deploying an Qt application on Qt for Embedded Linux is essentially the same as the deployment procedure on X11 platforms which is described in detail in the Deploying an Application on X11 Platforms documentation. See also the general remarks about deploying Qt applications.

In addition, there is a couple of Qt for Embedded Linux specific issues to keep in mind:


When Qt for Embedded Linux applications run, they look for a file called fontdir in Qt's /lib/fonts/ directory defining the fonts that are available to the application (i.e. the fonts located in the mentioned directory).

For that reason, the preferred fonts must be copied to the /lib/fonts/ directory, and the fontdir file must be customized accordingly. See the fonts documentation for more details about the supported font formats.

Note that the application will look for the /lib/fonts/ directory relative to the path set using the -prefix parameter when running the configure script; ensure that this is a sensible path in the target device environment. See the installation documentation for more details.

Environment Variables

In general, any variable value that differs from the provided default values must be set explicitly in the target device environment. Typically, these include the QWS_MOUSE_PROTO, QWS_KEYBOARD and QWS_DISPLAY variables specifying the drivers for pointer handling, character input and display management, respectively.

For example, without the proper mouse and keyboard drivers, there is no way to give any input to the application when it is installed on the target device. By running the configure script using the -qt-kbd-<keyboarddriver> and -qt-mouse-<mousedriver> options, the drivers are enabled, but in addition the drivers and the preferred devices must be specified as the ones to use in the target environment, by setting the environment variables.

See the pointer handling, character input and display management documentation for more information.

Framebuffer Support

No particular actions are required to enable the framebuffer on target devices: The Linux framebuffer is enabled by default on all modern Linux distributions. For information on older versions, see

To test that the Linux framebuffer is set up correctly, and that the device permissions are correct, use the program provided by the Testing the Linux Framebuffer document.

© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.