You are browsing documentation for a version other than the latest stable release. Switch to the latest stable release, 2.3.
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 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.
Make sure your Raspberry Pi has Raspbian OS installed.
Your first deployment is easy with 5 short steps:
SSH into your device:
The default password for the pi account is
You should now see a command prompt similar to the following:
Keep this terminal open as we will shortly use it to install the Mender client.
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.
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.
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.
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.
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! You have successfully deployed an application update using Mender!
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!
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 https://github.com/mendersoftware/integration.git integration cd integration
And finally fire up the demo server environment with:
Note that the demo up script starts the Mender services, adds a demo user with the username email@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.
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.
Compare plans and choose a plan that fits your requirements.