Skip to main content
Version: 0.13.1

Install

Announcement

thin-edge.io ❤️ 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.

Install/update

The easiest way to get started with thin-edge.io 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 thin-edge.io 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 thin-edge.io.

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

curl -fsSL https://thin-edge.io/install.sh | sh -s

Update using a package manager

thin-edge.io and its components can be updated by running the install.sh script again, or using the Linux package manager on your distribution.

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

If you have any trouble updating via the package manager, then run the install.sh 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

thin-edge.io 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 https://thin-edge.io/install-services.sh | sh -s

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

info

If the script detects that Systemd is installed, then it will not install anything as thin-edge.io 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 thin-edge.io executables/binaries.

Package ManagerFormatDistributions
aptdebDebian, Ubuntu and other debian-based operating systems
yum/dnf/microdnfrpmRHEL, RockyLinux, AlmaLinux, Fedora
zypperrpmopenSUSE
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 install.sh script in the installation section, however they can also be manually executed if you want more fine-grain control over the process.

tip

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.

Pre-requisites

The instructions require you to have the following tools installed.

  • curl
  • bash

Setup

Running with sudo

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

curl -1sLf 'https://dl.cloudsmith.io/public/thinedge/tedge-main/setup.deb.sh' | sudo bash

Running as root

These commands must be run as the root user.

curl -1sLf 'https://dl.cloudsmith.io/public/thinedge/tedge-main/setup.deb.sh' | 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 thin-edge.io 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 install.sh 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 thin-edge.io via the tarball run the following command:

curl -fsSL https://thin-edge.io/install.sh | 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 Cloudsmith.io website.

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