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, you need to set up a wired or wireless connection. See Raspberry Pi.

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. Open the VirtualBox network settings as follows:
    • In VirtualBox 4.x, select File > Preferences > Network.
    • In VirtualBox 5.x and 6.x, select File > Host Network Manager.
  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. Enable the DCHP server as follows:
      • In VirtualBox 4.x, open the DCHP Server tab and select the Enable Server check box.
      • In VirtualBox 5.x and 6.x, select the Enable check box for DCHP Server.
    3. Change the DCHP server address to
    4. Change the DCHP server mask to
    5. Change both the lower and upper address bounds for the DCHP server 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.