The Minimal IoT Platform — lightweight, single-binary, ready in 60 seconds.
English · 简体中文 · Live Demo · Documentation · Report Bug
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.
This release focuses on making Simple IoT easier to try, operate and present:
| 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.
git clone https://github.com/dingdaoyi/simple-iot.git
cd simple-iot
chmod +x deploy.sh
./deploy.sh deployThen 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.
| 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 |
| Notifications | Email & SMS push, HTTP callbacks, MQTT forward, device commands |
| Dashboard | Device totals, online stats, system metrics (CPU / memory / disk), live alarms |
| 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 and responsive layouts |
┌──────────────────────────────────────────────────────────────────┐
│ 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 │ │
│ └──────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────┘
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
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
- JDK 25+
- Node.js 18+
- pnpm 8+
- PostgreSQL 14+
- Docker & Docker Compose (optional, recommended)
# 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:runAPI ready at http://localhost:5010/iot/, OpenAPI at http://localhost:5010/iot/doc.html.
cd iot-web
pnpm install
pnpm devWeb ready at http://localhost:5173. Vite proxies /iot → http://localhost:5010 automatically.
See
AGENTS.mdfor the full coding conventions used by this project (component patterns, design tokens, naming rules).
- v0.1 — Stable single-node release, bilingual docs, CI, public demo
- v0.2 —
zh-CN/en-USUI, 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.
Contributions are very welcome. Whether it's a typo fix, a new protocol script, a UI tweak, or a translation — every PR helps.
- Read CONTRIBUTING.md
- Fork → branch → commit (use Conventional Commits:
feat:,fix:,docs:, ...) - Open a Pull Request
Found a bug or have a question? Open an issue or join the Discussions.
If you discover a security vulnerability, please do not open a public issue. See SECURITY.md for the responsible-disclosure process.
If this project helps you, please drop a star ⭐ — it's the easiest way to support the work and helps others discover it.
Apache License 2.0 © dingdaoyi & contributors
Built with ❤️ for makers, integrators and small teams shipping practical IoT products.