Skip to main content
Version: 0.12.0

How to install

Install via script

There are two possibilities to install, the easiest way is to use the installation script with this command:

curl -fsSL | sudo sh -s

You can execute that command on your device and it will do all required steps for an initial setup.


If you want to get a specific version, append the <version> 3 digits (e.g. 0.7.3):

curl -fsSL | sudo sh -s <version>

If you prefer to have a little more control over the installation or the script did not work for you, please go on with the manual installation steps.

Upgrade via script

If you already have on your device, to upgrade, the easiest way is to use the same script as the installation. Follow the steps below. There is no need to remove old version.


For version **0.7.7 or lower, to upgrade from these versions, all components must be stopped before upgrading.

The components are: tedge-mapper-c8y, tedge-mapper-az, tedge-mapper-collectd, tedge-agent, tedge-watchdog, c8y-log-plugin, c8y-configuration-plugin.

To stop tedge-mapper-c8y, tedge-agent, tedge-mapper-az, tedge-mapper-aws, you can simply run the commands below.

sudo tedge disconnect c8y
sudo tedge disconnect az
sudo tedge disconnect aws

To stop each component one by one, this is an example how to stop them with systemctl:

sudo systemctl stop tedge-mapper-c8y
sudo systemctl stop tedge-agent
sudo systemctl stop c8y-log-plugin

Run script as below to upgrade to the latest version.

curl -fsSL | sudo sh -s

If you want to upgrade to a specific version, append the <version> 3 digits, e.g. 0.7.3:

curl -fsSL | sudo sh -s <version>

Manual installation

To install thin edge package it is required to use curl to download the package and dpkg to install it.

Dependency installation has single dependency and it is mosquitto used for communication southbound and northbound e.g. southbound, devices can publish measurements; northbound, gateway may relay messages to cloud. mosquitto can be installed with your package manager. For apt the command may look as following:

sudo apt install mosquitto

Some OSes may require you to use sudo to install packages.

Download package package is in repository on GitHub:

To download the package from github repository use following command (use desired version):

curl -LJO<package>_<version>_<arch>.deb


  • version -> version in x.x.x format
  • arch -> architecture type (amd64, armhf, arm64)
curl -LJO

and for mapper:

curl -LJO

Install downloaded package

Now, we have downloaded the package we can proceed to installation. First we will install cli tool tedge.


Some OSes may require you to use sudo to install packages and therefore all following commands may need sudo.

To install tedge use following command:

sudo dpkg -i tedge_<version>_<arch>.deb
sudo dpkg -i tedge_0.5.0_armhf.deb

To install mapper for do:

sudo dpkg -i tedge-mapper_<version>_<arch>.deb
sudo dpkg -i tedge-mapper_0.9.0_armhf.deb


The can be uninstalled using a script, that can be downloaded from below mentioned location.

Whether you are just removing the packages or wanting to purge everything (removing the packages and configuration), there is a convenient one-liner provided under each section.

chmod a+x

The uninstall script provides options as shown below.


remove Uninstall with keeping configuration files
purge Uninstall and also remove configuration files

The uninstall script removes/purges the core packages like tedge, tedge-mapper, and tedge-agent as well as plugins like tedge-apt-plugin, c8y-log-plugin, c8y-configuration-plugin etc.


Use uninstall script as shown below just to remove the packages.

sudo ./ remove

./ remove removes just the packages and does not remove the configuration files.

The same thing can also be executed using a one-liner to download and run the script.

curl -sSL | sudo sh -s remove


Use uninstall script as shown below to remove the as well as to remove the configuration files that are associated with these packages.

sudo ./ purge

The same thing can also be executed using a one-liner to download and run the script.

curl -sSL | sudo sh -s purge