Getting Started with JetLinks: Open‑Source IoT Platform Built on Reactive Java Stack

Today I share an open‑source IoT foundation platform, JetLinks.

JetLinks is an enterprise‑grade IoT platform built on Java 8, Spring Boot 2.x, WebFlux, Netty, Vert.x, and Reactor. It supports unified device model management, flexible protocol integration, real‑time data processing, alarms, notifications, data forwarding, geolocation, and visualization, and all code is open‑source for plug‑and‑play or custom extensions.

The main technology stack and architecture are:

Spring Boot 2.3.x

Spring WebFlux (reactive web support)

R2DBC (reactive relational DB driver)

Project Reactor (reactive programming)

Netty, Vert.x (high‑performance networking)

Elasticsearch (full‑text search, logs, time‑series storage)

PostgreSQL (business data storage)

hsweb framework 4 (business foundation framework)

For device integration, a flow diagram illustrates the process.

Quick start options:

Run the whole environment with Docker:

cd docker/run-all
docker-compose up

Start the development environment with Docker and launch JetLinks from an IDE:

# Start environment
cd docker/dev-env
docker-compose up

Run without Docker: install PostgreSQL 11, Redis 5.x, Elasticsearch 6.7.2, then adjust application.yml in the jetlinks-standalone module and start the JetLinksApplication class, followed by the UI container:

docker run -it --rm -p 9000:80 -e "API_BASE_PATH=http://host.docker.internal:8848/" registry.cn-shenzhen.aliyuncs.com/jetlinks/jetlinks-ui-antd

After successful startup, access the platform at http://localhost:9000 with username “admin” and password “admin”.