Registering a test device

Before you start registering real devices it is a good idea to test the platform with a test device. You can register a test device and enable its "demo mode" to start receiving data right away.

Prepare the platform for new devices registration

Check that esthesis CORE is configured to accept new device registrations in Settings > Device registration > Registration mode. You can set it to "Open registration" for now, but do not forget to change it to a more secure setting later.

Which agent client to use

esthesis Device Agent comes as a standalone executable natively compiled for different platform, as well as a container image. You can choose the one that best fits your needs.

Native client

You can download the device agent from:

[todo: add link to download page]

The agent client is a command line tool that can be heavily customised for your esthesis CORE installation. You can view all the available configuration options by issuing:

./esthesis-device-agent --help

For a typical demo installation, you can run the device agent as:

./esthesis-device-agent \
	--hardwareId "test-device-1" \
	--registrationUrl "http://{{URL}}/api/agent/v1/register" \
	--demoInterval 5

Replace {{URL}} with the URL of your esthesis CORE UI installation.

Container client

The container client is available on Docker Hub and is built for multiple platforms and architectures:

esthesis Core Device Agent

For a typical demo installation, you can run the device agent as:

docker run -d \
	--name test-device-2 \
	--restart unless-stopped \
	-e HARDWARE_ID=test-device-2 \
	-e REGISTRATION_URL=http://{{URL}}/api/agent/v1/register \
	-e DEMO_INTERVAL=5 \
	esthesisiot/esthesis-core-device

Replace {{URL}} with the URL of your esthesis CORE UI installation.

Check the device registration

If registration was successful, you should see the device in the device list in esthesis CORE and the device should be sending data to the platform:

Last modified: 06 May 2025