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

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.


To follow this guide, you will need the following:

Get a hosted Mender account

Get a hosted Mender account by signing up here.

We provide three months free usage on the Mender Starter plan for you to use for evaluation. You can cancel at any time without incurring a cost.

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

Prepare your device

Make sure your Raspberry Pi has Raspbian OS installed.

  • Download Raspbian OS image from here.
  • Follow their steps to install the OS image to your device and enable SSH on your device. This should take less than 15 minutes.

Your first deployment is easy with 5 short steps:

Step 1 - SSH into your Raspberry Pi device

SSH into your device:


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 hosted Mender

Login to your hosted Mender 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 below. Keep this open as we will use it in the next step.

image alt text

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.

image alt text

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!

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.2.2 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, 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.