Updating (IoT)

Due to the complexity of the IoT box, and virtual Windows IoT box, the term ‘updating’ can mean several different things.

The actual drivers can be updated, the core code on the IoT box can be updated, or a new image can be flashed (using a physical IoT box).

This document explores the various ways to update IoT boxes to ensure smooth operation of IoT box processes and devices.

Flashing the SD card on IoT box


This update does not apply to the Windows IoT box (Odoo 16 and higher).

To update the Windows IoT, first, uninstall the previous version of the Odoo Windows program, and then reinstall it using the most up-to-date installation package.

To begin the installation, navigate to the Odoo 16 (or higher) installation package for Enterprise or Community - Windows edition, at Odoo’s download page.

In some circumstances, the IoT box’s micro SD Card may need to be re-flashed with Etcher software to benefit from Odoo’s latest IoT image update. This means the Odoo IoT box software may need to be updated in instances of a new IoT box, or when a handler’s update, or an update from the IoT box home page, does not resolve issues.


  • It is often necessary to re-flash the IoT box’s image after upgrading the Odoo database to a new version.

  • A computer with a micro SD card reader/adapter is required to re-flash the micro SD card.

First, begin by downloading Etcher. It is a free, open-source utility, used for burning image files onto drives. After the download completes, install and launch the program on the computer.

Then, download the latest IoT image from nightly, which will be labeled as iotbox-latest.zip. This particular image is compatible with all supported versions of Odoo.

After this step is complete, insert the IoT box’s micro SD card into the computer or reader. Open Etcher, and select Flash from file, then find and select the iotbox-latest.zip image and extract it. Next, select the drive the image should be burned to.

Lastly, click Flash, and wait for the process to finish.

Balena's Etcher software dashboard.


Balena’s Etcher software also allows for the administrator to flash the SD card from a URL. To flash from a URL, simply click Flash from URL, instead of Flash from file.

Then, enter the following: http://nightly.odoo.com/master/iotbox/iotbox-latest.zip.

A view of Balena's Etcher software, with the flash from URL option highlighted.


An alternative software for flashing the micro SD card is Raspberry Pi Imager.

Update from the IoT box home page

In the background, the IoT box uses a version of Odoo code to run and connect to the Odoo database. This code may need to be updated in order for the IoT box to operate effectively. This operation should be completed on a routine basis, to ensure the IoT system, and its processes, stay up-to-date.

Go to the IoT box home page by navigating to IoT app ‣ IoT Boxes, and clicking on the IP address of the IoT box. Then, click on Update (next to the version number).

If a new version of the IoT box image is available, an Upgrade to _xx.xx_ button appears at the bottom of the page. Click this button to upgrade the unit, at which point the IoT box flashes itself to the newer version. All of the previous configurations are then saved.


This process can take more than 30 minutes. Do not turn off, or unplug, the IoT box, as it would leave it in an inconsistent state. This means the IoT box needs to be re-flashed with a new image.

IoT box software upgrade in the IoT Box Home Page.

Handler (driver) update

There may be some instances where drivers or interfaces need to be updated for individual devices (e.g. scales, measurement tools, etc.). The IoT handler’s (drivers and interfaces) code can be modified by syncing them with the configured server handler’s code.

This can be helpful in instances where IoT devices (e.g. scales, measurement tools, etc.) are not working properly with the IoT box.

For both the Windows IoT (Odoo 16 and higher) and physical IoT box, this process can be performed manually from the IoT box home page. Go to the IoT box home page by navigating to IoT app ‣ IoT Boxes, and clicking on the IP address of the IoT box.

Next, click Handlers list, and then select Load Handlers at the bottom of the page.

Handlers list on an IoT box with the load handlers button highlighted.


Handler’s code is fetched from the configured server, and it needs to be up-to-date to have the latest fixes and patches.


A handler update is also performed automatically each time the IoT box is restarted. The only exception to this process is if the Automatic drivers update is unchecked in the form view of the IoT box on the Odoo server. This setting can be reached by going to IoT App ‣ Select the IoT box ‣ Automatic drivers update.