---

✨ What is Simple IoT?

Simple IoT is a self-hosted IoT platform for teams that want to connect devices, model telemetry, build rule flows and operate alarms without assembling a large distributed stack first.

The project keeps the runtime intentionally compact: one Spring Boot application, one Vue 3 console, PostgreSQL for business data, InfluxDB for telemetry and Docker Compose for deployment. It is easy to read, fork, run on a small server and adapt to real projects.

🌟 Release Highlights

v0.3.0 - Drivers + Ingress (2026-07-31)

Area	What's new
Webhook Ingress	HMAC-SHA256 signed HTTP endpoint for third-party push. Per-webhook token + secret, replay protection, frontend CRUD with curl guide.
Modbus TCP	Per-device polling, register mapping, multi-function-code read, scale + data-type conversion. Demo modbus-sim included.
System monitoring	Real CPU / memory / disk metrics on dashboard (replaces placeholder zeros).
UI audit	8 pages unified to PageHeader + glass-card + el-empty empty states, -40 lines duplicate CSS.

v0.2.0 - Real-time + Operations (2026-07-23)

Area	What's new
Real-time dashboard	WebSocket push for telemetry & alarm channels, 2 new widget types (device status grid, alarm list).
Schedule triggers	Cron-based rule chain execution via INPUT_SCHEDULE node.
IM push	DingTalk, WeCom, Feishu webhook notifications with CRUD config UI.
Batch operations	Multi-device command dispatch with per-device result tracking.
Device topology	Parent-child device relationships for gateway-subdevice scenarios.
Data retention	InfluxDB telemetry auto-purge (configurable, default 180 days).
Security	API rate limiting (Bucket4j), audit logging (AOP), alarm suppression (5-min dedup).
Docs	8 new VitePress guide pages (zh + en). 190 unit tests. Platform maturity 75%.

v0.1.1 - Usability (2026-06-25)

Area	What's new
International UI	Full zh-CN / en-US frontend i18n, semantic translation keys, language switcher and Element Plus locale sync.
Rule-chain authoring	Improved editor usability with canvas zoom/pan, keyboard shortcuts, node search, validation and debug path highlighting.
Scriptable automation	Script filter nodes and safer protocol/script test handling: user script mistakes now return readable validation results instead of noisy server errors.
Integration reliability	Push configuration validation, signed push testing and better delivery-setting checks.
Demo & release quality	Hardened GitHub Actions, frontend lint in CI, stable demo deployment and public smoke verification.

In short — Simple IoT is a practical, lightweight IoT console you can run yourself, inspect end-to-end and evolve with your product.

---

🚀 Quick Start (60 seconds with Docker)

git clone https://github.com/dingdaoyi/simple-iot.git
cd simple-iot
chmod +x deploy.sh
./deploy.sh deploy

Then open:

Service	URL	Default credentials
Web UI	http://localhost	admin / 123456
API docs	http://localhost:5010/iot/doc.html	—
MQTT broker	mqtt://localhost:1883	—
MQTT WebSocket	ws://localhost:8083/mqtt	—

The Docker stack seeds a demo sensor by default (demo-sensor-001 / demo-secret) so the dashboard and MQTT smoke path are useful immediately. See MQTT Quick Test for a copy-paste telemetry publish command.

That's it. PostgreSQL, RustFS (S3-compatible), the backend and the frontend all spin up together.

Want to develop locally? See the development guide.

---

🎯 Core Features

Module	What it does
Device Management	Registration, online/offline tracking, batch operations, command dispatch
Product & Thing Model	Product types, properties, services and events for structured device capabilities
Protocol Engine	Hot-loaded scripts in Java / JavaScript / Groovy / Lua, no restart needed
Visual Rule Engine	Drag-and-drop chain editor with validation, debug paths, script filters and reusable nodes
Alarm Center	Severity levels (info / warning / critical / urgent), active / cleared lifecycle
Data Ingestion	InfluxDB 3 time-series storage, Caffeine in-process cache
Dashboard	Device totals, online stats, system metrics (CPU / memory / disk), live alarms, WebSocket real-time, device-grid & alarm-list widgets
Notifications	Email & SMS push, HTTP callbacks, MQTT forward, device commands, DingTalk / WeCom / Feishu IM push
Real-time	WebSocket push for telemetry, alarms, and device status changes
Data Retention	InfluxDB telemetry auto-purge (configurable, default 180 days)
Security	API rate limiting (Bucket4j), audit logging (AOP), alarm suppression (5-min dedup)
Auth & Permissions	Sa-Token based, fine-grained, role/menu/button level
International UI	Modern Vue 3 console with zh-CN / en-US, light/dark/auto theme, PWA support, responsive layouts

---

🖼️ Screenshots

---

🏗️ Architecture

┌──────────────────────────────────────────────────────────────────┐
│                          Simple IoT                              │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│   Vue 3 + Vite + Element Plus  (Minimal UI)                │
│           │                                                      │
│           ▼  REST / WebSocket                                    │
│   ┌──────────────────────────────────────────────────────────┐   │
│   │   Spring Boot 4 (single JVM, single binary)              │   │
│   │                                                          │   │
│   │   • Sa-Token auth         • MyBatis-Plus                 │   │
│   │   • Caffeine local cache  • Knife4j OpenAPI              │   │
│   │   • Visual rule engine    • Hot-loaded protocol scripts  │   │
│   │   • mica-mqtt broker (1883 / 8083 ws)                    │   │
│   └──────────────────────────────────────────────────────────┘   │
│           │                          │                           │
│           ▼                          ▼                           │
│   ┌──────────────┐          ┌────────────────┐                   │
│   │ PostgreSQL   │          │ InfluxDB 3     │                   │
│   │ (business)   │          │ (telemetry)    │                   │
│   └──────────────┘          └────────────────┘                   │
│                                                                  │
│   ┌──────────────────────────────────────────────────────────┐   │
│   │  Devices  →  MQTT / TCP / HTTP  →  Protocol scripts      │   │
│   └──────────────────────────────────────────────────────────┘   │
└──────────────────────────────────────────────────────────────────┘

Stack

Backend — Java 25 · Spring Boot 4.0.2 · Sa-Token · MyBatis-Plus · PostgreSQL · InfluxDB 3 · mica-mqtt · Caffeine · Hutool · AWS S3 SDK Frontend — Vue 3 · Vite · Element Plus · Pinia · Vue Router · Axios · ECharts Infra — Docker Compose · RustFS (S3-compatible) · GitHub Actions

---

📦 Project Layout

simple-iot/
├── iot-server/         # Main Spring Boot service (REST + MQTT broker + rule engine)
├── iot-common/         # Shared base classes (BaseEntity, ResultCode, paging)
├── iot-driver/         # System-supplied protocol drivers
├── iot-web/            # Vue 3 admin frontend
├── doc/                # Docs, SQL schema, screenshots, brand assets
├── docker-compose.yml  # Stack: postgres + rustfs + iot-server + iot-web
├── deploy.sh           # One-command deploy / start / stop / logs
└── pom.xml             # Maven multi-module build

---

🛠️ Development

Prerequisites

• JDK 25+
• Node.js 18+
• pnpm 8+
• PostgreSQL 14+
• Docker & Docker Compose (optional, recommended)

Backend

# 1. Start PostgreSQL + RustFS only (skip backend/frontend)
docker compose up -d postgres rustfs

# 2. Run the server in your IDE / via Maven
cd iot-server
mvn spring-boot:run

API ready at http://localhost:5010/iot/, OpenAPI at http://localhost:5010/iot/doc.html.

Frontend

cd iot-web
pnpm install
pnpm dev

Web ready at http://localhost:5173. Vite proxies /iot → http://localhost:5010 automatically.

See AGENTS.md for the full coding conventions used by this project (component patterns, design tokens, naming rules).

---

🗺️ Roadmap

• v0.1 — Stable single-node release, bilingual docs, CI, public demo
• v0.2 — zh-CN / en-US UI, rule-chain editor polish, demo deploy hardening
• v0.3 — thing-model import/export, device groups
• v0.4 — Custom data dashboards (drag-and-drop widgets)
• v0.5 — OTA upgrade flow, edge gateway packaging
• v0.6 — Plugin system (protocol packs as standalone JARs)
• v1.0 — Production hardening, performance benchmarks, helm chart

Open an issue or Discussion if there's a feature you want to see prioritised.

---

🤝 Contributing

Contributions are very welcome. Whether it's a typo fix, a new protocol script, a UI tweak, or a translation — every PR helps.

1. Read CONTRIBUTING.md
2. Fork → branch → commit (use Conventional Commits: feat:, fix:, docs:, ...)
3. Open a Pull Request

Found a bug or have a question? Open an issue or join the Discussions.

---

🛡️ Security

If you discover a security vulnerability, please do not open a public issue. See SECURITY.md for the responsible-disclosure process.

---

⭐ Star History

If this project helps you, please drop a star ⭐ — it's the easiest way to support the work and helps others discover it.

---

📄 License

Apache License 2.0 © dingdaoyi & contributors

---