Creating a QNX pod and checking its status

In this section, you create a pod; a logical entity which holds one or more containers that share common resources (e.g., network namespace). You must create a QNX Pod before instantiating a QNX Container.

A pod sandbox configuration file specifies the parameters to use when creating the Pod, For details, refer to Appendix: Pod Sandbox Configuration.

Note:

All Pod names must be globally unique in the configuration file.

In the following example, you create the pod which uses a POD network namespace. The namespace instructs qcmgr to create a virtual network stack, and assigns an IP address to the stack:

echo "{
	\"config\": {
		\"metadata\": {
			\"name\": \"podsandbox1\"
		},
		\"qnx\": {
			\"network_namespace\":0
		},
		\"hostname\": \"hostname1\"
	}
}" > /tmp/pod-config.json

Note:

Only IPv4 addressing is currently supported when using the POD network namespace mode.

To create the above configuration, run qcmctl pod create:

# qcmctl pod create -I /tmp/pod-config.json
1c9351f553bdb7a51b39914ea24ad77b6ecb84283ccd6fd9561a15463c44c391

The pod ID is returned on the output.

To list the pods in the system, run qcmctl pod list:

# qcmctl pod list
NAME         POD ID       STATE   CREATED
podsandbox1  1c9351f553bd Ready   2025-04-26 11:37:37

To view a pod's status, run qcmctl pod status:

# qcmctl pod status podsandbox1
FIELD        VALUE
Name         podsandbox1
Pod ID       1c9351f553bdb7a51b39914ea24ad77b6ecb84283ccd6fd9561a15463c44c391
State        Ready
IP Address   172.17.0.4
Created      2025-04-26 11:37:37
Containers   0

You should see that this pod has an allocated IPv4 address and no associated containers.

You should now be ready to create your first QNX Container under this pod.

Page updated: July 16, 2026