Mender 2.3 released: Easily update both system and applications
We are excited to release Mender 2.3 and 2.2.2!
The focus for Mender 2.3 is to easily update all your device software.
This Mender release includes a ready-to-flash OTA-enabled Raspbian image, a new way to snapshot into system updates and support for generating application updates directly from the Mender server! All new features of Mender 2.3 are fully open source under the permissive Apache 2.0 license.
The key features of Mender 2.3 are covered below, and you can see the detailed items in the Mender 2.3.0 release notes.
Rasbian image with system-level OTA update support
System updates are needed in order to update the kernel, system libraries, application frameworks or even more complex applications. Losing power or connectivity during these types of updates can leave the device "bricked", unless a robust update process is used, like the one provided by Mender that does dual A/B system updates and support rollback in case of any type of failure.
Supporting this type of advanced system update, however, requires integration with bootloaders and several low-level changes. Thus, getting started with robust OTA system updates on Raspbian has never been easy -- until now.
Mender 2.3 comes with a ready-to-flash Rasbian image for the Raspberry Pi 3. The only difference between the official Raspbian image is that Mender has been integrated and it is fully enabled to receive robust system updates! Note that this image only works with Raspberry Pi 3.
This Raspbian image is available for download in the Mender documentation.
If you are looking for or are interested in testing and contributing board support for other Debian family of OSes, take a look at the Debian family board integration category in the Mender Hub community forums.
Broader Debian family board support with mender-convert v2
mender-convert is the tool that enables system update support for boards running
a Debian family OS, such as Debian, Raspbian and Ubuntu. In fact, it is how the
Raspbian image above has been created.
In its initial release it supported BeagleBone and Raspberry Pi 3 boards, but with the new mender-convert v2, it has become fully generic and does not have any limitations on which boards it can support!
Given the heterogeneous nature of embedded devices, however, there might be specific configurations that are needed for different boards. This is now supported by board-specific configuration files, rather than having any specific board support in mender-convert itself.
For an example, take a look at the Raspberry Pi 4 Raspbian board integration.
To start using this new version of
mender-convert, take a look at the
documentation for Debian family boards.
Wizard for Mender client configuration: mender setup
Once you have the Mender client installed on your device, it should be connected to a Mender server, so that remote updates can be deployed. This used to mean locating configuration files, reading about the different options and changing configuration settings.
Mender 2.3 greatly simplifies this with a new setup command. To trigger the command on an
existing installation of Mender, simply run
mender setup, which will launch a CLI wizard
as shown below:
# mender setup Mender Client Setup =================== Setting up the Mender client: The client will regularly poll the server to check for updates and report its inventory data. Get started by first configuring the device type and settings for communicating with the server. The device type property is used to determine which Mender Artifact are compatible with this device. Enter a name for the device type (e.g. raspberrypi3-raspbian): [raspberrypi3-raspbian] Are you connecting this device to hosted.mender.io? [Y/n] Y Enter your credentials for hosted.mender.io Email: email@example.com Password: Demo mode uses short poll intervals and assumes the default demo server setup. (Recommended for testing.) Do you want to run the client in demo mode? [Y/n] Y Mender setup successfully.
This command can be triggered after flashing an image with Mender integrated, like the Raspbian image above, and is also run by default after you install the Mender Debian package (support for application level updates only).
Easily generate system updates: mender snapshot
With Mender integrated and running on the devices a way to generate system updates is needed.
On the Debian family of OSes, like Raspbian, it is common to start off with the "golden image" workflow to generate system updates. In this workflow, one device or SD card, acts as the source that is later replicated to all the other devices. All changes, such as updating libraries, changing configurations and installing applications are applied run-time at the golden image.
This used to be a quite cumbersome workflow because you would have to boot the golden device, do the modifications needed, shut down the device, move the SD card into a workstation/laptop, dump it to a image file, shrink and compress it, and finally generate an update based on this image. Phew!
Mender 2.3 introduces a new client-side feature to reduce this to a single step:
This feature is best used when you have the golden device connected to a workstation / laptop and you
can SSH into it, which is usually the case.
mender snapshot on the device itself will temporarily suspend all writes to the device storage and
dump the contents of the currently running system, which can be forwarded to a file or
To make this system update generation into a single step, a complementary option has been added to
mender-artifact, the tool used to generate Mender Artifact (
.mender) files for update deployment.
It now supports taking the input over SSH, so you can generate a Mender Artifact from your golden device
by running a command like this on your workstation/laptop:
mender-artifact write rootfs-image -f ssh://firstname.lastname@example.org \ -n release-1 \ -o release-1.mender \ -t raspberrypi3
After a few minutes, the Mender Artifact (
release-1.mender) can be uploaded to the Mender server
and deployed to all of the devices, which would essentially replicate the system of the golden device!
Since this is a full root file system snapshot, it enables other use cases as well, such as backup and restore of the running system.
Upload applications and configurations directly to the Mender server
To deploy new software or configuration with Mender, it needs to be packaged in the
Mender Artifact (.mender) format.
This format contains meta-data to ensure the compatibility and integrity of your software updates,
and it can be managed with the
However, for simple use cases like updating a single python application or configuration file
across all the devices, working with the
mender-artifact tool can become a bit tedious.
This is why Mender 2.3 introduces a new way to easily generate application-based updates, right from the
Mender server web UI itself. You can simply upload the file you want to deploy (e.g.
and the Mender server will package it and make it available for deployment!
The screenshot above shows a python application file uploaded to the Mender server, you can choose where it should be deployed.
In this first version, single files can be packaged. However, as this feature is built around Update Modules, there will be server-support for many more types of updates in future versions; check out the other Update Modules enabling support for docker, directory and package managers. It is even possible to create custom Update Modules, to update any type of software with Mender.
The downloads section of the documentation is growing to cover more tools and architectures, so you do not have to compile them yourself.
Mender 2.3 introduces new prebuilt binaries for the following tools and target architectures:
- Mender client: arm64 and amd64
- mender-cli: Linux and MacOS
Yocto Project support
Mender 2.3 continues to support the
warrior (2.7) Yocto Project release. Support for
zeus (2.8) is in progress
and will be added to a future release.
Server-side dependency updates
Mender 2.3 uses the new, official version of the MongoDB Golang driver and MongoDB 3.6, which improves general performance for database access. It also comes with ElasticSearch 6 to take advantage of new features and performance improvements.
Try Mender 2.3
The documentation has a new 2.3 section that includes all the necessary resources. To test the new features, start with these pages:
Support for your board
If you are getting started with OTA updates, or do not have time to integrate the Mender client with your board for robust A/B system updates, there are several resources available to you!
The Board Integrations category in Mender Hub is a community site to contribute, reuse and maintain Mender board integrations.
We are also happy to help with consulting services to enable verified Mender support for your board!
Share your feedback
We appreciate your general feedback on Mender, be it positive or need for improvement, in the Mender Hub General Discussions forum. Your continued feedback ensures Mender will meet your needs even better in the future!
If you believe you have encountered a bug, please submit your report at the Mender JIRA issue tracker.
We hope you enjoy the new features and are looking forward to hearing from you!