Requirements for Linux/X11

Instructions in this documentation assume Ubuntu Linux 64-bit 16.04 LTS or later. Other Linux distributions may work, but have not been tested.

Minimum Hardware Requirements

Approximate minimal hardware requirements for running Boot to Qt are:

  • 256 MB of RAM
  • 500 MHz CPU, 1 GHz preferred for 60-FPS velvet-smooth UI
  • OpenGL ES 2.0 support *

* On GPU-less hardware, Qt Quick 2D Renderer can replace the OpenGL ES 2.0 requirement (with some limitations on graphics capabilities).

Installing Platform Dependencies

Before you can build the applications with Qt for Device Creation, you must have the correct build tools and other dependencies installed in the development host:

C/C++ build essentialsQt for Device Creation assumes that a C++ compiler, debugger, make, and other development tools are provided by the host operating system.
PythonRequired by the Qt for Device Creation toolchain installer. The minimum version is Python 2.7.
libusb-1.0Required by the QDB tool.

You can install the dependencies with the following command in a terminal:

sudo apt-get install build-essential python2.7 libusb-1.0-0

Note: The requirements for building your own embedded Linux image are listed in Yocto Build Environment Requirements.

If you have problems with installing the build essentials, see https://help.ubuntu.com/community/InstallingCompilers.

Setting Up USB Access to Embedded Devices

If you target only the emulator, you can skip this step.

Note: If you target Raspberry Pi or NVIDIA Jetson TX1, you need to set up a wired or wireless connection. See the target device guides:

On Ubuntu Linux, the development user account must have access to plugged in devices. To allow the development user access to the device via USB, create a new udev rule.

  1. From Qt 5.9 onwards, run the following command in a shell:
    echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="dbdb", TAG+="udev-acl", TAG+="uaccess"' | sudo tee -a /etc/udev/rules.d/70-boot2qt.rules

    For Qt 5.8 or older, run the following command in a shell:

    echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", TAG+="udev-acl", TAG+="uaccess"' | sudo tee -a /etc/udev/rules.d/70-boot2qt.rules
  2. Connect the running device to the development host with a USB cable. If the device is already connected, disconnect and reconnect the USB cable after running the command above.

The system log files /var/log/udev and /var/log/syslog may provide relevant information in case of connection problems.

Requirements for Boot to Qt emulator

The Boot to Qt emulator in Qt for Device Creation relies on VirtualBox virtualization software. You can download it from https://www.virtualbox.org/wiki/Downloads or install it via the distribution tools. The minimum version is VirtualBox 4.3.

Installing VirtualBox on the Older Ubuntu version

If you are running an older Ubuntu system such as 12.04, the version of VirtualBox provided by the distribution is not recent enough. To install a newer version, first add a foreign package source:

wget -q http://download.virtualbox.org/virtualbox/debian/oracle_vbox.asc -O- | sudo apt-key add -
echo "deb http://download.virtualbox.org/virtualbox/debian $(lsb_release -sc) contrib" | sudo tee /etc/apt/sources.list.d/virtualbox.list
sudo apt-get update

Then, install VirtualBox on your computer:

sudo apt-get install virtualbox-4.3

Configuring VirtualBox

After you have installed VirtualBox, configure it:

  1. Start the VirtualBox user interface.
  2. Select File > Preferences > Network to open VirtualBox network settings.
  3. Create a new host-only network. VirtualBox automatically assigns a name for the new host-only network. On Linux the default name is vboxnet0.

    Note: If the created host-only network is not named as vboxnet0, you must change the VirtualBox settings to use the created host-only network. In VirtualBox:

    • Select Boot2Qt-59 machine in the VirtualBox main view.
    • Select Machine > Settings > Network > Adapter 1 and choose the created host-only network in the Name field.
  4. Edit the properties of the created host-only network:
    1. Change the IPv4 address to and the IPv4 network mask to
    2. In the DCHP Server tab, select the Enable Server check box.
    3. Change the server address to
    4. Change the server mask to
    5. Change both the lower and upper address bounds to

If a firewall is enabled on the development host, it needs to allow TCP and UDP packets between your host and the virtual machine.

Available under certain Qt licenses.
Find out more.