Skip to main content
Version: Torizon OS 6.x.y

Torizon OS Reference Minimal Image Technical Overview


This article shows an overview of the Torizon OS Reference Minimal image capabilities, intended use, and differences compared to the ready-to-use Torizon OS. It highlights how you can leverage it to customize the Torizon OS using Yocto Project/Open Embedded and have easy access to Torizon Cloud features.


What is Torizon OS Reference Minimal Image?​

Torizon OS Reference Minimal Image is an embedded Linux reference image built on top of Toradex Linux BSP Layers. As with every other reference image from Toradex, Torizon OS Reference Minimal Image is a starting point for the development process of our customers.

It inherits all the configurations, device drivers and kernel modules from Torizon OS, including the components for secure offline and remote over-the-air (OTA) update. However, it does not feature a container engine, so it is not possible to use Docker containers out of the box.

Unlike Torizon OS, the Torizon OS Reference Minimal Image is not a ready-to-use operating system!

Intended Use​

Torizon OS Reference Minimal Image aims to enable and facilitate the customization of Torizon OS through the usage of Yocto Project/OpenEmbedded. It also facilitates the usage of Torizon Cloud features while keeping a Yocto Project/OpenEmbedded development environment.

Torizon OS Reference Minimal Image gives a starting point for the customization, offering the base Yocto layers used to build your operating system with the minimum requirements. To customize the reference image and then, have an operating system suitable to your specific needs, first, you have to understand the basics of the Yocto Project. Then, it's important to:

  1. Understand about Toradex reference images offerings: refer to BSP Layers and Reference Images for Yocto Project Software.
  2. Understand about how to build a Toradex reference image: refer to Build a Reference Image with Yocto Project/OpenEmbedded and Build Torizon OS from Source With Yocto Project/OpenEmbedded.
  3. Understand the process of creation and customization of layers: refer to Custom meta layers, recipes and images in Yocto Project (hello-world examples).

Torizon OS and Torizon OS Reference Minimal Image​


The reference minimal image gathers the elements of the Toradex BSP and Torizon layers. In other words, it contains the Linux kernel, drivers, configurations and the necessary Yocto Project layers to customize, configure, and build it. This is shown in the diagram below:

Application Architecture with Torizon OS

In addition, it also contains the necessary structure to allow you to remotely update your system. For more information, refer to the section Torizon updates: OSTree and Aktualizr.

Furthermore, the notable difference from the Torizon OS is that Torizon OS takes the basic elements of the reference image and adds the container runtime resources, making it a ready-to-use Linux-based operating system for you to develop your application. If you are looking for more information about Torizon OS, refer to Torizon OS Technical Overview.

Some characteristics of the Torizon OS Reference Minimal image:

  • Toradex offers a pre-built binary image of Torizon OS Reference Minimal that contains only the essential command-line utilities. This image is designed solely for testing purposes and should not be used in a production environment. It is highly recommended to use Yocto Project to add your application, and customize and re-build the Torizon OS from source by using its reference image as a base. This approach ensures that the final image is tailored to meet your specific needs and does not require the usage of containers.

  • As is Torizon OS, the reference minimal image is open-source. Toradex provides the necessary instructions to build it with Yocto.

  • Toradex maintains its BSPs with updated software for bootloader and Linux kernel, preferetially using mainline components. In recently launched platforms, the BSP may contain downstream SoC vendor components until Toradex recognizes the mainline stack as mature enough to be deployed to production.

  • The developers can also follow the Toradex Yocto Project BSP Layers release roadmap and Torizon OS release roadmap page to get updated information about known issues, scheduled bug fixes, and feature improvements.

Linux Kernel​

As can be seen on the diagram of the Architecture section, the main components of the Kernel remain the same for the Torizon OS and the Torizon OS Reference Minimal Image. So, if you are looking for information in this regard, refer to Linux Kernel section on the Torizon OS Technical Overview article.

Torizon updates: OSTree and Aktualizr​

Similar to Torizon OS, the reference image adopts the usage of Aktualizr and OSTree to allow for Remote and Offline Updates, and you can push images to Torizon Cloud directly using your Yocto Builds. Learn more at Build Torizon OS from Source with Yocto Project/OpenEmbedded.

For more information on this topic, refer to Torizon Remote Updates and Secure Offline Updates.

In the future, Toradex plans to support multiple update solutions, allowing customers to choose or implement solutions other than OSTree.

Extra Resources​

Webinar: How to add OTA Updates and other IoT features to your Yocto image​

Send Feedback!