You are browsing documentation for a version other than the latest stable release. Switch to the latest stable release, 2.3.
Mender is an open source remote software updater for embedded Linux devices. It enables management of software updates to connected devices remotely over any TCP/IP network. For a high-level introduction to Mender and its architecture, we recommend reading the What is Mender page on Mender.io.
This section of the documentation contains tutorials to help you deploy your first update with Mender.
Going from a fresh system to completing your first deployment with Mender, including server setup, should take less than 1 hour!
Do not follow this getting started documentation if you are using Hosted Mender. Instead, follow the instructions you received in the welcome email when you signed up to Hosted Mender.
For quickly testing the Mender server, we have created a demo version that does not take into account production-grade issues like security and scalability. When you are ready to install for production, please follow the Production installation documentation.
The Mender server is using the microservices design pattern, meaning that multiple small, isolated services make up the server. In order to make it easy to test Mender as a whole, we have created a Docker Compose environment that brings all of these components up and connects them together on a single machine. It also includes a virtual device for you to test with, which is handy because it means that you can test Mender without having to configure any hardware.
We assume you are using Ubuntu 18.04 with Google Chrome as web browser and at least 10 GB free disk space and 2 GB RAM available for Mender.
Follow the documentation to install Docker Engine, version 17.03 or later.
Invoking the docker commands may fail when the local user has insufficient permissions to connect to the docker daemon. In Ubuntu 18.04, the user must be a member of the
docker group to be able to access it. Please check the documentation for your host OS if you encounter connection issues with docker.
Follow the documentation to install Docker Compose, version 1.6 or later.
While bringing up the environment, several gigabytes of docker images may be downloaded. We recommend using a fast Internet connection in order to avoid long wait times.
It is very likely possible to use the test environment on other platforms, versions, or with less resources. We recommend using this exact environment for testing Mender because it is known to work and you will thus avoid any issues specific to your test environment if you use this reference.
The Mender updater client is designed to run on embedded Linux devices and connects to the server so that deployments can be managed across many devices.
To get support for robust system updates with rollback, Mender must be integrated with production devices. For testing system updates, we provide pre-built demo images for the Raspberry Pi 3 and BeagleBone Black devices with the latest version of Mender.
On the other hand, if you only need support for application updates (not full system updates), no device integration is required. In this case you can install Mender on an existing device and OS by following the documentation on installing the Mender client.
After installing the above prerequisites, follow the steps in Install a Mender demo server.