QNX Containers 1.0 Release Notes

QNX Containers 1.0 provides containerization support for QNX Software Development Platform (SDP) 8.0.5 that is compliant with the specification of the Open Container Initiative (OCI).

QNX Containers run in a contained space with network and filesystem restrictions, as well as controlled services. The host system of the containers manages the CPU and memory restrictions, as well as scheduling behaviour.

QNX Containers support pulling Docker and OCI images from container registries and deploying the images on QNX targets.
Note:
Early access QNX Container images may not run with QNX Containers 1.0. The early access images may need to be re-created with a change in the permissions of the directory rootfs.

Target hardware

This product can run on x86_64 and AArch64 platforms.

Development host OSs

You must install QNX SDP 8.0.5 onto a development host with one of the following 64-bit operating systems:

  • Microsoft Windows 11, or Windows 10
  • Ubuntu Desktop 24.04 LTS, Ubuntu Desktop 22.04 LTS, or Red Hat Enterprise Linux 9
Note:
  • QNX SDP 8.0 doesn't support host systems that use ARM processors.
  • QNX SDP 8.0 doesn't support macOS.

Contents

What's in this release

On QNX Software Center (QSC), QNX Containers 1.0 is packaged as QNX SDP 8.0 Containers. The following table shows its package information and its included child packages:
Name Package ID Package internal version
QNX SDP 8.0 Containers (Group package) com.qnx.qnx800.target.containers.group 1.0.0.00006T202606120701L
QNX SDP 8.0 Container Manager com.qnx.qnx800.target.containers.manager 1.0.0.00006T202606120701L
QNX SDP 8.0 Container Runtime com.qnx.qnx800.target.containers.runtime 1.0.0.00006T202606120701L
QNX SDP 8.0 Container Utilities com.qnx.qnx800.target.containers.utils 1.0.0.00006T202606120701L
This installation includes the qrunc, qcmgr, and qcmctl binaries and their associated libraries.

Installing QNX Containers 1.0

Before installing QNX Containers 1.0, you must install QSC 2.0.4 and QNX SDP 8.0.5. For information about installing QSC, refer to Install and launch the QNX Software Center in the QNX Software Center User's Guide.

To install QNX Containers 1.0:
  1. From QSC, select Install New Packages > Available.
  2. Search for QNX SDP 8.0 Containers.
  3. Select the group package QNX SDP 8.0 Containers, and then select Install.

Required supporting binaries

The QNX Containers binaries and associated libraries are:
  • qcmgr
  • qrunc
  • qcmctl
  • libqcmgr.so
  • libqrunc.so
On the target, the QNX image must include the following binaries:
  • jail
  • tar
  • libcontainer.so
The binaries must be found in the executable $PATH so qcmgr can use them, and they should be added to the image build configuration file.

Third party applications

In addition to the QNX SDP development environment, the following third party applications are recommended to build and store container images:
Docker engine - v29
You can use the Docker engine to build container images. For Docker installation instructions, refer to https://docs.docker.com/engine/install/ubuntu/.
Docker registry - v3
You can use a local Docker registry to store images. For local Docker registry installation instructions, refer to https://www.docker.com/blog/how-to-use-your-own-registry-2/.
AWS Command Line Interface (CLI) - v2
To use Amazon Elastic Container Registry (ECR) to store images, install the AWS CLI tool. For AWS CLI installation instructions, refer to https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html.

Known issues

QNX Containers 1.0 has the following issue(s):
Description Workaround Reference Number
The terminal input for exec -it and bash is not echoed back to terminal. Use ksh instead of bash. 3026419
QNX Containers 1.0 may not be able to process images created with recent versions of Docker that include OCI attestation metadata (provenance/SBOM) which results in nested OCI indexes. When building a QNX Container application image, you can use one of the following workarounds:
  1. In the makefile container.mk, add the following parameters to the docker build command: 
    --provenance=false --sbom=false
    Or:
  2. Build the image with a legacy Docker build, run the following commandline: 
    DOCKER_BUILDKIT=0 make install
 3031857
A process inside a container has limited access to a directory shared with the host. More specifically, it can:
  • create a new file in the shared directory,
  • modify a new or existing file in the shared directory.
However, it cannot:
  • delete any files in the shared directory,
  • access any sub-directories in the shared directory.
 Use a flat directory structure to share files between a container and the host. Delete shared files from the host when they are no longer needed. 3031940

The known issues for QNX SDP 8.0 are described in the QNX Software Development Platform 8.0: Known Issues document that's stored in the QNX Download Center. Log in and go to: https://www.qnx.com/download/group.html?programid=74127.

Technical support

To obtain technical support for any QNX product, go to the Support area on our website: https://blackberry.qnx.com/en/support. You'll find a range of support options.

For product experience and roadmap information, contact QNX Product Management.

Page updated: