Installing and running QNX Cabin for Cloud

Updated: March 11, 2025

This chapter describes how to install and run the QNX Cabin for Cloud.

This chapter contains the following topics:

Setting up a Hypervisor AMI

You must set up a Hypervisor AMI instance with the minimum volume requirement of 48GiB for Cabin and a guest image of Android or Yocto Linux. For details on setting up the Hypervisor AMI instance, go to the QNX Amazon Machine Image Technotes

Note: You should prepare back-up solutions (e.g., back-up images) and perform sanity checks to make sure the instance is functional.
You must configure the instance's security group to allow the following ports:
Table 1. List of ports required for the QNX Cabin AMI
Protocol Port number or range Description
ICMP All ping
TCP 22 Host SSH
TCP 24 Yocto SSH
TCP 3478 WebRTC Turn Server
TCP 4000 LiveAMP
TCP 5555 Android ADB
TCP 8000 qconn
TCP 8080 lighttpd
TCP 8443 WebRTC Server
UDP 3478 WebRTC Turn Server
UDP 49152-65535 WebRTC Turn Server

Create and copy your guest image to your AMI instance

You need to create the Android or Yocto guest image and copy the guest image to your instance.

To create and copy a guest image:
  1. Create the Android or Yocto guest using the following instructions:
  2. Use mkqnx6fsimg to create a qnx6 partition image that includes your guest.
    Note: The sector size is 512.
  3. Name the partition image guests.image.
  4. Copy the created guests.image to /dev/shmem. Here's an example of the guest directory structure:
    • /guests/android/Android14-auto/kernel-5.10
    • /guests/android/Android14-auto/vendor_ramdisk
    • /guests/android/Android14-auto/android14-disk.img
    • /guests/linux/Yocto/core-image-weston-qvmaarch64.ext4
    • /guests/linux/Yocto/Image
    • /guests/android/Android14-auto/graviton2-vm.dtb

Installing and running the Cabin image

After setting up your Hypervisor instance with the guest image, install and run the QNX image on your instance.

To install and run Cabin:
  1. On the development host:
    1. Download QNX Cabin on AWS Gravitoncom.qnx.qnx710.target.cabin.AWS_Graviton* from the QNX Software Centre.
    2. Copy the image archive files from [installation folder]/target to your instance using your key pair (PEM file) and the IP of your instance. For example:
      scp -i [pem path] target/qnx7/aarch64le/images/Cabin/vCabin_b[build_number].zip
          qnxuser@[instance IP]:/dev/shmem
  2. Run Cabin using the following commands on the instance:
    cd /dev/shmem
    tar -xvf vCabin_b[build_number].zip
    ksh ./copy_and_run_auto_img.sh
    Note: The script ./copy_and_run_auto_img.sh performs a partition fixing workaround that allows the instance to use a bigger physical disk space than the default disk image size of 4GiB (i.e., “growing disk”). Currently in QNX SDP 7.1, the MBR (or GPT) partition editing tool, pted, doesn't support “growing disk” partition fixing; a future QNX SDP 7.1 patch will address this.

By default, the QNX cloud target automatically runs the webrtc-server-iosock WebRTC utility and the screen graphics utility, so you can immediately access the WebRTC interface. Go to the Using the WebRTC server chapter to start using the WebRTC graphics and audio.