An update module to manage device configuration via Mender Configure add-on. See Mender Docs for an overview of the add-on.
mender-configure is the update module responsible for fetching and reporting configuration, and requires the user to use one or multiple
apply-device-config script(s) to apply the configuration on the device. See Mender Docs guide How to make an apply-device-config script for more details.
- Setting timezone
- Setting WiFi credentials
- Setting firewall rules
- Setting any user-specific configuration parameters
|Artifact generation script||No(**)|
|Full system updater||No|
|Source code||GitHub repository|
(*) It depends on the user provided apply-device-config scripts
(**) The Artifact is generated in the Mender UI
This section describes how to set up 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 Mender client, version 2.0 or later
Follow the instructions that correspond to your device setup.
mender-configure is available in
dunfell-v2021.04 and newer. If you are using
meta-mender-demo layer, the Update Module is added to your image by default together with some apply-device-config script. If not, you can add it to your image with
IMAGE_INSTALL_append = " mender-configure"
mender-configure is available for
mender-convert builds, and is enabled setting the following variable:
The specific version to install can also be configured if desired. See Mender Docs page for more information.
mender-configure is also available in the Mender APT repository. Follow instructions in Mender Docs to install the repository in your device. Then, install
sudo apt-get update sudo apt-get install mender-configure
Alternatively to all the above, it is possible to install from source. Follow these steps:
git clone -b 1.0.1 https://github.com/mendersoftware/mender-configure-module.git cd mender-configure-module make install
To actually apply the configuration on your device, Mender relies on user supplied apply-device-config scripts. See Mender Docs guide How to make an apply-device-config script for a complete guide on how to write such scripts.
As an example, see the timezone script which sets the timezone of the device, according to the “timezone” key, given in the file in the first argument.
The configuration Artifacts are generated by the Mender Server on the fly, so no local use of
mender-artifact nor other generation scripts are required. See Mender Docs for more information.