Skip to content

Container Usage

Docker Container

The XRT docker container allows you to explore the capability of the available components, and to develop and verify components by providing suitable configuration.

The docker image only initializes the following components, which are described in Core Components:

  • Bus
  • Logger
  • Scheduler
  • ThreadPool

Any other required components must be dynamically loaded by including the factory and library names in the configuration files.

To obtain the XRT docker image, based on Alpine 3.13, enter the following command, where <version> identifies the version of XRT:

docker pull iotechsys/xrt:<version>

For example, to pull version 1.2.0 of XRT, the command would be as follows:

docker pull iotechsys/xrt:1.2.0

The configuration needed to run the container must be provided using a bind mount, in the following format:

docker run - -rm - v <path to config>/config:/opt/iotech/xrt/config - it iotechsys/xrt:<version>
[timeout in secs]

By default, the timeout is set to infinity; if you want to stop the container, you can press Ctrl + C.

The root configuration must be in a file named main.json.

Before starting the docker container you must copy your XRT license file, provided by IOTech Support, to the config directory. The license file must be renamed from Xrt_license.lic to license.json.

Back to top