Skip to main content
Version: 0.13.1


Announcement ❤️ Linux so we now support installing thin-edge on any Linux distribution!

Systemd is still the default init system (aka. service manager), however if you don't have Systemd, then it won't be used. You are then free to configure your own service manager to run thin-edge how you want, or use one of the community supported packages.


The easiest way to get started with is to use the installation script which will auto detect the installation method appropriate for your Linux distribution. The script will configure the package manager and install and its dependencies (e.g. mosquitto). If your distribution does not have one of the supported package managers, then the tarball will be used to install

To install or update to the latest version, run the following command:

curl -fsSL | sh -s

Update using a package manager and its components can be updated by running the script again, or using the Linux package manager on your distribution.

sudo apt-get update
sudo apt-get install tedge-full

If you have any trouble updating via the package manager, then run the script again. The install script will install or update the script as well as configure the appropriate package manager for your Linux distribution.

Optional: Linux distributions without Systemd uses Systemd by default to run all of its components as background services. If your Linux distribution does not have Systemd installed, then you will also have to run one more additional step.

Run the script below to automatically detect and install the relevant service definitions for the init system provided by your Linux distribution.

curl -fsSL | sh -s

Check out the init systems for more information on the service definitions.


If the script detects that Systemd is installed, then it will not install anything as comes with Systemd service definitions.

Supported Linux Package Managers

The following Linux Package Managers are supported out-of-the-box. For all other Linux distributions, the tarball (.tar.gz binary) can be used to add the executables/binaries.

Package ManagerFormatDistributions
aptdebDebian, Ubuntu and other debian-based operating systems
yum/dnf/microdnfrpmRHEL, RockyLinux, AlmaLinux, Fedora
apkapkAlpine Linux
-tarball (*.tar.gz)All other Linux distributions, e.g. Yocto

Alternative installation methods

In cases were you would not like to run the automatic install script, you can choose one to run the steps manually. This allows you more control over the process which can be useful if you are experiencing problems with the auto detection used in the install script.

Manual repository setup and installation

The software repositories used by the package managers can be configured using the setup scripts. These scripts are normally executed by the script in the installation section, however they can also be manually executed if you want more fine-grain control over the process.


If you are having problems setting any of the repositories, check out the Cloudsmith website where they have Set Me Up instructions in additional formats, e.g. manual configuration rather than via the setup.*.sh script.


The instructions require you to have the following tools installed.

  • curl
  • bash


Running with sudo

You will need to have sudo also installed if you want to run these instructions.

curl -1sLf '' | sudo bash

Running as root

These commands must be run as the root user.

curl -1sLf '' | bash

Installing and updating using a package manager

Once you have the repository setup, you can install the tedge-full virtual package which will automatically pull in all of the packages. This makes it easier to install and update in the future, as you only have to type in one package name, tedge-full.

sudo apt-get update
sudo apt-get install tedge-full

Install via tarball

You can force the script to install via the tarball instead of via a package manager. The install script will also take care of the required post installation steps.

To install the via the tarball run the following command:

curl -fsSL | sh -s -- --package-manager tarball

Package repository hosting

Hosted By: Cloudsmith

Package repository hosting is graciously provided by Cloudsmith. Cloudsmith is the only fully hosted, cloud-native, universal package management solution, that enables your organization to create, store and share packages in any format, to any place, with total confidence.

The packages can be viewed directly from the website.

Debian logoLatest version of 'tedge-full' @ Cloudsmith
RedHat logoLatest version of 'tedge-full' @ Cloudsmith
Alpine logoLatest version of 'tedge-full' @ Cloudsmith