This page describes how to install the Mender client on an existing Linux system. Installing Mender this way does not offer a full Mender board integration, so you can not carry out full system updates, however, it is possible to use Update Modules to update applications and other parts of the system.

If you need the full board integration, follow the device documentation in System Updates: Yocto Project or System Updates: Debian family.

Install Mender using the Debian package

Mender provides a Debian package (.deb) for convenience to install on e.g Debian, Ubuntu or Raspberry Pi OS. The package supports the following architectures:

  • armhf (ARM-v6): ARM 32bit distributions, for example Raspberry Pi OS for Raspberry Pi or Debian for BeagleBone.
  • arm64: (ARM-v8): ARM 64bit processors, for example Debian for Asus Tinker Board
  • amd64: Generic 64-bit x86 processors, the most popular among workstations

See the downloads page for links to download all package architectures.

Download the package

wget$(dpkg --print-architecture)/mender-client_master-1%2Bdebian%2Bbuster_$(dpkg --print-architecture).deb

The above link will use the native architecture. See the downloads page for other architectures, and also make sure to modify the references to the package in commands below.

Option 1: Attended installation with a wizard

The Mender package comes with an install wizard that will let you configure and customize your installation. This is the recommended option for new users.

To install and configure Mender run the following command:

sudo dpkg -i mender-client_master-1+debian+buster_$(dpkg --print-architecture).deb

After completing the installation wizard, Mender is correctly set up on your device and automatically starts in managed mode. Your device is now ready to authenticate with the server and start receiving updates.

Option 2: Unattended installation

Alternatively, install the package non-interactively. This is suitable for scripts or other situations where no user input is desired.

First, to install Mender without configuring it run the following command:

sudo DEBIAN_FRONTEND=noninteractive dpkg -i mender-client_master-1+debian+buster_$(dpkg --print-architecture).deb

The setup is different depending on your server configuration and the most common cases are shown below. Use mender setup --help to learn about all configuration options.

Set the following variables:


Configure Mender with:

sudo mender setup \
            --device-type $DEVICE_TYPE \
            --hosted-mender \
            --tenant-token $TENANT_TOKEN \

Finally, to restart the Mender service for the new configuration to take effect run the following command:

sudo systemctl restart mender-client

Install from source

As an alternative to using a Debian package, it is possible to install the Mender client from source by following the guidelines outlined in the of the Mender client source repository.

We welcome contributions to improve this documentation. To submit a change, use the Edit link at the top of the page or email us at .