# \[ Topic template \] for contributing Update Modules

**URL:** https://hub.mender.io/t/topic-template-for-contributing-update-modules/316
**Category:** Update Modules
**Tags:** how-to
**Created:** [March 7, 2019, 12:31pm UTC](https://hub.mender.io/t/topic-template-for-contributing-update-modules/316 "2019-03-07T12:31:49Z")
**Posts on this page:** 3
**Page:** 1

<div class="post-metadata">

### Author: ![michaelatmender](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/michaelatmender/32/128_2.png) [@michaelatmender](https://hub.mender.io/u/michaelatmender)
#### Post date: [March 7, 2019, 12:31pm UTC](https://hub.mender.io/t/topic-template-for-contributing-update-modules/316/1 "2019-03-07T12:31:49Z")

</div>

**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.

## Description

_ **TODO** : Add a high level description of the Update Module functionality_

Example use-cases:

- _ **TODO** : add example use-cases here_

## Specification

_ **TODO** : List the specs of the Update Module in below table_

| Specification | |
| --- | --- |
| 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.

### Prerequisites

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

- [Install the Mender client](https://docs.mender.io/client-installation/install-with-debian-package), version 2.0 or later
- _ **TODO** : Add additional dependencies_

### Install the Update Module

Download the latest version of this Update Module by running:

```bash
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.

### Prerequisites

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

- [Install mender-artifact](https://docs.mender.io/downloads), version 3.1.0 or later
- _ **TODO** : Add additional dependencies_

### 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](https://docs.mender.io/artifact-creation/standalone-deployment).

### Artifact technical details

_If necessary, any technical details of the Artifact contents that might be of interest for users_

---

<div class="post-metadata">

### Author: ![michaelatmender](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/michaelatmender/32/128_2.png) [@michaelatmender](https://hub.mender.io/u/michaelatmender)
#### Post date: [April 2, 2019, 3:13pm UTC](https://hub.mender.io/t/topic-template-for-contributing-update-modules/316/2 "2019-04-02T15:13:19Z")

</div>



---

<div class="post-metadata">

### Author: ![michaelatmender](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/michaelatmender/32/128_2.png) [@michaelatmender](https://hub.mender.io/u/michaelatmender)
#### Post date: [April 2, 2019, 3:14pm UTC](https://hub.mender.io/t/topic-template-for-contributing-update-modules/316/3 "2019-04-02T15:14:19Z")

</div>


