[ Topic template ] for contributing Update Modules

NOTE! This has the same content which is presented when you press the “+ New Topic” button, but we store this here for traceability. All updates to this topic must be pushed to “Update Modules” → “Edit” → “Topic Template” as well. That is the raw markdown content.


TODO: Add a high level description of the Update Module functionality

Example use-cases:

  • TODO: add example use-cases here


TODO: List the specs of the Update Module in below table

Module name < name >
Supports rollback < yes/no >
Requires reboot < yes/no >
Artifact generation script < yes/no >
Full operating system updater < yes/no >
Source code < link >
Maintainer < Community/maintainer email>

TODO: Consider removing below warning if you deem your Update Module to not fit the description.

Please be aware that Mender Update modules are meant to update parts of the operating system and if not configured properly they could potentially delete parts or the complete operating system. Always inspect the code carefully and only test modules on a device that you can recover easily.

It is not recommended to install a Mender Artifact on your workstation

Prepare the device

This section describes how to setup your target device, i.e. the device to be updated. This will also be referred to as the device environment.

All commands outlined in this section should be run in the device environment.


This update module has the following prerequisites for the device environment:

Install the Update Module

Download the latest version of this Update Module by running:

TODO: Insert install command here

Prepare the development environment on your workstation

This section describes how to set up your development environment on your workstation.

All commands outlined in this section should be run in the development environment.


This Update Modules has the following prerequisites for the development environment:

Create Mender Artifacts

TODO: Add instructions on how to generate Artifacts, using mender-artifact tool or a provided script

You can either deploy this Artifact in managed mode with the Mender server (upload it under Releases in the server UI) or by using the Mender client only in Standalone deployments.

Artifact technical details

If necessary, any technical details of the Artifact contents that might be of interest for users