Container engine

esthesis EDGE publishes linux/amd64 and linux/arm64 container images as part of its release process. Images are pushed to Docker Hub.

Requirements

A container engine runtime.
A MariaDB (11.x or newer) database.
Access to an InfluxDB (2.7.x or newer) database (optional, if you need local data sync).
Access to esthesis CORE (optional, if you need esthesis CORE data sync).

Standalone installation

The standalone installation instantiates esthesis EDGE in your container engine without bringing up additional components, such as MariaDB and InfluxDB. At minimum, you need to provide access to a MariaDB for your container to be operational.

The following command demonstrates how you can start esthesis EDGE as a Docker container, specifying a minimal configuration providing local data sync to an existing MariaDB. For a full list of configuration option, see Configuration.

docker run \
    -p 8080:8080 \
    -e QUARKUS_DATASOURCE_JDBC_URL=jdbc:mariadb://some-mariadb:3306/esthesis-edge \
    -e QUARKUS_DATASOURCE_USERNAME=root \
    -e QUARKUS_DATASOURCE_PASSWORD=root
    esthesisiot/esthesis-edge:latest

You can quickly test esthesis EDGE is up and running by executing:

curl localhost:8080/q/health

Compose installation

A Docker Compose file is provided to instantiate esthesis EDGE together with all its dependencies to support local data sync. The default configuration will instantiate esthesis EDGE, together with a MariaDB database, as well as an InfluxDB database. You can download the Docker Compose file from the esthesis EDGE GitHub repository, or download it with ORAS via:
oras pull docker.io/esthesisiot/esthesis-edge-docker-compose:latest

To start esthesis EDGE with Docker Compose, execute:

docker compose up

Last modified: 26 March 2025