Skip to main content
Version: Toradex Easy Installer version 6

Flash a New Image Using Toradex Easy Installer


This article provides a guide on flashing a new OS image (custom build or pre-built image) using the Toradex Easy Installer tool. If you need to customize the Toradex Easy Installer image, see How to Modify a Toradex Easy Installer Image, Toradex Easy Installer Configuration Files and How to Customize Toradex Easy Installer Boot.

Why flash a new OS image using Tezi?

As mentioned in the Toradex Easy Installer Overview, Tezi is the recommended way to flash your image onto Toradex SoMs. You might face one of these cases:

  • Factory default status: Toradex Easy Installer is flashed in the factory as the default image. You will be able to see the tool's GUI on your screen after booting the module for the first time and installing the pre-built image of your choice.
  • The SoM already has an Operating System flashed: If your module already has an Operating System and you want to install another OS, custom build or not, you can download Tezi image and load it into the module's RAM through a host computer over USB OTG (see the Load Toradex Easy Installer article).

In any of those cases, using Tezi is the most straightforward way to do it.


Flash a Toradex Pre-built Image

Display the GUI

To access the Tezi interface, you must:

  1. Use a Display as output: Once the Toradex Easy Installer is loaded into RAM, you should see a User Interface appearing on the DVI-I/HDMI, VGA, or on the parallel RGB (Unified Interface Display) ports of your carrier board (obviously a display must be connected at that port). The default outputs are:

    • DVI-I/HDMI port on Apalis
    • RGB with VGA resolution on Colibri
    • HDMI through the Verdin DSI to HDMI Adapter on Verdin. (HDMI hotplug is not supported. You must connect the HDMI cable with the board powered off and only then power it on).
  2. Use a remote desktop as output: If you can't use any of these display options, you can access the user interface remotely over the network using VNC. For this, you should connect a USB cable to the USB / OTG port of your carrier board. The module provides a connection via USB RNDIS with the default IP address of


    The USB / OTG port we refer to is the same one used to enter recovery mode. Refer to the article iMX Recovery Mode to find the correct port for your carrier board.

    Alternatively, you can use the IP address of the ethernet interface, which will depend on the DHCP server serving your LAN.

    Use your preferred VNC client to connect to this address. For example:

    $ vncviewer

    For Windows 10, we recommend using TightVNC. For Linux, we recommend Vinagre.

Provide OS Images

To provide the OS images to Tezi, you have two options:

  1. Online installation (preferred): this is the easiest method. To list images from the Internet, make sure that you connect the board via Ethernet to a network that provides Internet access (the installer relies on DHCP to configure the IP address and HTTP to download images). After some seconds you should see a list of images appearing.

  2. Offline installation: Alternatively, if you cannot connect the board directly to the internet, you can use an external media with a pre-built image or a custom image. Once you plug it into the board, the images should appear in the list of available images with an icon indicating that it is found on a local storage device.


Please insert the SD card in X19 (SD/MMC 4 bit) if you are using Apalis TK1 with Apalis Evaluation Board.

Install OS Images

Preparation for Offline installation
  1. Prepare your external media (a USB stick or SD card): its filesystem must be formatted as FAT32 or ext4.
  2. Download the desired image from Toradex Download Links (Torizon, Linux BSP, WinCE and Partner Demos). The download will be a .tar file.
  3. Extract the .tar file to your external media (a USB stick or SD card). The extraction will result in a folder with the name as the image.
  4. Your external media is ready to be recognized by Toradex Easy Installer running on your module.


  • You can have more than one image extracted in your external media, as long as each image is in its own folder.
  • You can keep files unrelated to Toradex Easy Installer in your external media. They won't be modified.

Toradex Installer Main Menu

To install an image:

  1. Use a USB mouse or USB keyboard to select the desired image.
  2. Click on the "Install (i)" button or press "i" to start the installation.
  3. Follow the instructions until installation begins.

After the image has been successfully installed you should see the following message on your screen:

Toradex Easy Installer done

At this point, all data have been stored on internal flash and caches have been flushed (synced). It is not required to click on any of these three buttons, it is perfectly fine to just reset or turn off the system.

Enable the Toradex CI Feed and Add Your Own Feeds

If you want to add more sources to Toradex Easy Installer (such as adding your own server to it), use the Feeds button.

Enable Toradex Continuous Integration Server

A simple test can be done by allowing the Toradex Continuous Integration Server (testing) option.

Send Feedback!