You are browsing documentation for a version other than the latest stable release. Switch to the latest stable release, 2.2.

Quickstart with Raspberry Pi

Quickly and easily deploy your first over-the-air (OTA) software update with Mender using a secure server we host for you. We will take you through installing Mender on your device and deploying a simple application update on your Raspberry Pi and Raspbian OS.

Prerequisites

To follow this guide, you will need the following:

Get a Mender Professional account

Get a Mender account by signing up here.

We provide $120 free credit for you to use for evaluation. You can cancel at any time without incurring a cost while your usage remains under $120.

You can also try it on-premise, but it requires more effort getting setup. See the on-premise instructions below.

Prepare your Raspberry Pi 3

First we flash a Raspbian image that has Mender integrated to the SD card and configure it. This should take less than 15 minutes.

The only difference from the official Raspbian image is that it has been converted to support robust A/B system updates and the Mender client has been installed. Note that the image will only work on Raspberry Pi 3, for now.

If you have a different board than the Raspberry Pi 3 you can still follow the Mender product onboarding tooltips and deploy a demo application to your device. But you will not be able to do system updates without Mender integration later on.

Your first application deployment is easy with 5 short steps:

Step 1 - SSH into your Raspberry Pi device

SSH into your device:

ssh pi@<DEVICE-IP-ADDRESS>

The default password for the pi account is raspberry.

You should now see a command prompt similar to the following:

pi@raspberrypi:~ $

Keep this terminal open as we will shortly use it to install the Mender client.

Step 2 - Login to Mender Professional

Login to your Mender Professional account, and when on the main page for the first time new users will get a tutorial in the Mender web GUI.

Go to the Dashboard tab and click on Connect a device. Then Click on Connect my own device. Select your Raspberry Pi model and click Next. You should see a screen similar to the one below. Keep this open as we will use it in the next step.

connecting a device

Step 3 - Install the Mender client on your device

Next we will install the Mender client on your device and connect it to the Mender server.

In the dialog box from step 2, click Copy to clipboard to copy the code to install the Mender client. Now go to the command line on your device from step 1, and paste the code e.g. by right-clicking in the terminal and selecting Paste, followed by Enter.

This downloads the Mender client on the device, configures and starts it.

Once the client has started, the Mender client will attempt to connect to the server and it will appear in your Pending devices tab in the server. Go ahead and Accept the pending device in the server. After accepting the device, it will appear on the Device groups tab on the left of Pending.

accepting the device

Step 4 - Create a Deployment

There is already a mender-demo Artifact available under Releases the first time you use Mender. It contains a small web server your device can run.

Go to the Deployments tab and select the target release already available and click Create deployment as shown below.

create a deployment

After about 30 seconds you see your finished deployment in the Finished tab. There should also be a tooltip to the URL of your deployed web server.

congratulations server

Once you access your device using the URL shown in the tooltip under the Finished tab you should see a welcome page similar to the following.

congratulations device

Congratulations! You have successfully deployed an application update using Mender!

Step 5 - Modify the application

The onboarding tooltips should now take you through modifying the web page you saw in step 4, using tools to generate Mender Artifact (.mender) files. Simply follow the tooltips to update your newly deployed application!

Deploy system level updates

So far, we deployed an application update. However, Mender also supports robust system level updates with rollback that you might want to test out. If you used the Raspberry Pi 3 image with Mender integrated, it already supports system level updates as well!

The easiest way to create system level updates is to use the snapshot functionality in Mender; follow the documentation on Artifact from system snapshot.

Running Mender on-premise

For the easiest and fastest experience, we recommend using the hosted version of Mender for your first evaluation. You can also try the same deployment above using the on-premise version by installing a Mender demo server on a host machine, however this will take you a bit longer. You will need to install Docker Engine (on device) and Docker Compose in your deployment environment.

Next, you will need to download the Mender integration environment in the working directory:

git clone -b 2.3.0b1 https://github.com/mendersoftware/integration.git integration

cd integration

And finally fire up the demo server environment with:

./demo up

Note that the demo up script starts the Mender services, adds a demo user with the username mender-demo@example.com, and assigns a random password in which you can change after you log in to the Mender web UI. The Mender UI can be found on https://localhost.

After you log into the UI on the localhost you can follow steps 1 through 5 listed above.

Have any questions?

If you need help and have any questions:

  • Visit our community forum at Mender Hub dedicated to OTA updates where you can discuss any issues you may be having. Share and learn from other Mender users.

  • Learn more about Mender by reading the rest of the documentation.

Compare plans and choose a plan that fits your requirements.