Skip to content

Connecting QEMU VMs and ctrlX CORE

This document describes how SDK App Build Environments (resp. QEMU VMs) and a ctrlX CORE can be connected.

In our examples we are assuming a Windows 10 host with px.exe as local proxy.

Connections between Host and SDK QEMU VMs

A SDK QEMU VM is always connected to it's host computer via port forwarding. So from the hosts point of view services of a SDK VM are a reachable via the address localhost:FORWARDED_PORT

In our examples below port 10022 of the host is forwarded to port 22 (SSH) of the SDK amd64 VM and port 20022 to port 22 of SDK aarch64 VM.

From the SDK QEMU VMs perspective:

  • is the IP address of the host computer
  • is also used as gateway address *1)
  • is the URL of the proxy server px.exe running on the Windows host

*1) The QEMU instance emulates a gateway server. This makes it possible that other network participants can be reached via their IP address. The QEMU internal gateway service routes the network packages to their destinations.

Connection Between Host and ctrlX CORE Controls

There are three ways to connect ctrlX controls:

  1. ctrlX COREvirtual with Port Forwarding configured in ctrlX WORKS
  2. ctrlX COREvirtual with virtual Network Adapter configured in ctrlX WORKS
  3. ctrlX CORE

ctrlX COREvirtual with Port Forwarding

Like the SDK VMs the ctrlX COREvirtual is connected via port forwarding which is configured in ctrlX WORKS. When the ctrlX COREvirtual is started port forwarding is done by an internally started QEMU instance.

ctrlX with port forwarding

In the picture above port 12345 is used for C++ remote debugging and its forwarding has to be configured in ctrlX WORKS too.


If port 8443 of the host is forwarded to port 443 of the ctrlX (default) add sslport=8443 to the TCP connection string:

In this case the connection string has this suffix ?sslport=8443:


Otherwise change port forwarding to 443:443.

ctrlX COREvirtual with Network Adapter

In this case a ctrlX COREvirtual is provided by ctrlX WORKS and its internal QEMU instance with a virtual network adapter. The default IP address of this adapter is

To connect the Windows host with the ctrlX COREvirtual a so called TAP Windows Adapter v9 is created by ctrlX WORKS.

ctrlX CORE

The connection string for ctrlX Data Layer access in this case is:


ctrlX CORE

The ctrlX CORE is connected to the Windows host via its network adapter.

The connection string for ctrlX Data Layer access e.g. is: