[ Topic template ] for contributing Apply Device Configuration Scripts

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 “Apply Device Configuration Scripts” → “Edit” → “Topic Template” as well. That is the raw markdown content.

Description

TODO: Add a high level description of the Apply Device Configuration Script functionality

Example use-cases:

  • TODO: add example use-cases here

Specification

TODO: List the specs of the Apply Device Configuration Script in below table

Script name < name >
Configuration key(s) evaluated < comma separated list of keys >
Version < version >
Source code < link >
Maintainer < Community/maintainer email >

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

Please be aware that Mender apply-device-config scripts are meant to update and configure 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 scripts on devices that you can recover easily.

Prepare the device

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

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

Prerequisites

This apply-device-config script has the following prerequisites for the device environment:

Install the apply-device-config script

Download and install the script by running:

**TODO**: Insert install command here

Usage

TODO: Describe the Script’s basic usage patterns and scenarios.