Installation

Depending on your environment, you may want to run the esthesis device agent as a Docker container, or as a standalone executable. The following sections describe how to install the device agent in both scenarios.

Docker

The esthesis device agent can be found in Docker hub as the https://hub.docker.com/repository/docker/esthesisiot/esthesis-core-device/general image. The esthesis device agent supports a plethora of configuration options (see Configuration parameters), however the minimum configuration required to successfully start it up and have it connect to esthesis CORE is the following:

docker run \
	-e HARDWARE_ID=test-device-1 \
	-e REGISTRATION_URL=http://esthesis-core.domain/api/agent/v1/register \
	esthesisiot/esthesis-core-device

Docker images are maintained for the following architectures:

linux/arm/v6
linux/arm/v7
linux/arm64
linux/amd64

Standalone executable

Download the standalone executable matching your operating system and architecture from the releases page. Start the device agent with the following command:

./esthesis-core-device \
	--hardwareId=test-device-1 \
	--registrationUrl=http://192.168.22.10/api/agent/v1/register

Native standalone executables are maintained for the following architectures:

darwin/amd64
darwin/arm64
linux/amd64
linux/arm/5
linux/arm/6
linux/arm/7
linux/arm64
windows/386
windows/amd64

Last modified: 06 May 2025