You are browsing documentation for a version other than the latest stable release. Switch to the latest stable release, 2.3.
This page describes how to install the Mender client in an existing Linux system. Installing this way does not offer a a full Mender integration. However, it is possible to use Update Modules and update parts of the system.
It is possible to install the Mender client from source by following the guidelines outlined in the README.md of the Mender client source repository.
A Debian package (
.deb) is provided for convenience to install on e.g Debian, Ubuntu or Raspbian. We provide packages for the following architectures:
Download the package:
Install the package:
sudo dpkg -i mender-client_2.0.1-1_armhf.deb
After successfully installing the Mender client Debian package, some initial setup is required.
First, we have to configure the Mender client using the configuration file at
By default Mender uses production-grade configuration settings. However, if this is a test or development device, it is recommended to use the demo settings to get shorter polling intervals.
Copy the demo configuration file:
sudo cp /etc/mender/mender.conf.demo /etc/mender/mender.conf
To configure the Mender client for Hosted Mender, you need to edit
/etc/mender/mender.conf and insert your Tenant Token
where it says "Paste your Hosted Mender token here".
TENANT_TOKEN="<INSERT YOURS FROM https://hosted.mender.io/ui/#/settings/my-organization>"
Update configuration file with your token:
sudo sed -i "s/Paste your Hosted Mender token here/$TENANT_TOKEN/" /etc/mender/mender.conf
The device type is a string that defines your device and is used to ensure software compatibility by comparing the device type set in a Mender Artifact with the string on the device.
In below example we will set the device type to
raspberrypi3, adjust according to your desired device type identifier.
Create Mender client state directory:
sudo mkdir -p /var/lib/mender
Create the device type file:
echo "device_type=raspberrypi3" | sudo tee /var/lib/mender/device_type
Now you have the Mender client installed and properly setup in your device.
Start the Mender client in managed mode and enable autostart of the Mender service on subsequent boots:
sudo systemctl enable mender && sudo systemctl start mender
After a few minutes, take a look at the Devices tab in your Mender server. You should see your new device under "Pending". Click "Accept" to authorize it to join your Mender server. You are now ready to deploy updates to your device!
If your device does not show up, follow the troubleshooting section on Mender Server Connection Issues.