Search by Tags

Capturing Changes in the Configuration of a Board on TorizonCore


Article updated at 17 Feb 2021
Subscribe for this article updates

Select the version of your OS from the tabs below. If you don't know the version you are using, run the command cat /etc/os-release or cat /etc/issue on the board.

Remember that you can always refer to the Torizon Documentation, there you can find a lot of relevant articles that might help you in the application development.

Torizon 5.0.0


During the development process with TorizonCore, usually it is required to capture configuration changes on the /etc directory that needs to be committed to the TorizonCore image.

Here are some examples of articles describing procedures that require changes in the configuration of the system.

This article shows how to capture these system configurations.

This article complies to the Typographic Conventions for Torizon Documentation.


The pre-requisite to complete these instructions are:

Installing TorizonCore Builder

To use TorizonCore Builder, you need to create an alias. Follow the installation instructions on the TorizonCore Builder article. Make sure to:

  • Unpack the TorizonCore image, as explained in the article.
  • Use an empty working directory and navigate to it. This directory is shared (bind-mounted) with the TorizonCore Builder container, and it stores temporary files and the final image.

Capturing Changes in the Configuration of a Board

If the user has made any configuration changes, e.g., the /etc directory, the isolate command will get all those changes (modifications, addition, deletion, and files and directories permissions and ownership). It requires an ssh connection for the communication between the host PC and the target board.

Get configuration changes from the target board

$ torizoncore-builder isolate --remote-host --remote-username torizon --remote-password 1234
isolation command completed

Attention: In order to keep credentials (files and directories permissions and ownership) the isolate command will create the file /etc/.tcattr which will be automatically used later by the union command.

Merge changes to base Toradex Easy Installer image of Torizon. Use any "--union-branch" name you want; as example we use changes_committed:

$ torizoncore-builder union --union-branch=changes_committed
Commit d77ed9d5ddec41b7b61f9a571e810de2447133391ee19fe5f34d1a81009967d1 has been generated for changes and ready to be deployed.

Use the previously created changes_committed branch to generate a custom TorizonCore image, ready to be installed with the Toradex Easy Installer:

$ torizoncore-builder deploy changes_committed --output-directory deployed_image

Optionally, deploy the previously created changes_committed branch directly on the target board:

$ torizoncore-builder deploy changes_committed --remote-host --remote-username torizon --remote-password 1234 --reboot